返回市场
企业搜索分析-MCP服务器

企业搜索分析-MCP服务器

作者:koki-develop2 星标更新:2025-09-18

项目介绍

[!IMPORTANT] 正式的MCP服务器已发布。请从此以后使用官方服务器。

esa MCP Server

版本 许可证 Docker

这是为esa.io提供的模型上下文协议(MCP)服务器。

目录

用法

前提条件

在使用此MCP服务器之前,您需要从您的esa.io团队生成一个个人访问令牌:

  1. 访问 https://<TEAM_NAME>.esa.io/user/applications
  2. 创建一个新的个人访问令牌
  3. 复制令牌以进行配置

配置

您可以使用npx或Docker来运行服务器。

使用npx

在您的MCP客户端中添加以下配置:

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": [
        "-y",
        "@koki-develop/esa-mcp-server@latest"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

<your-team-name><your-personal-access-token>替换为您自己的团队名称和个人访问令牌。

使用Docker

如果您更喜欢使用Docker,请使用以下配置:

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_TEAM",
        "-e",
        "ESA_ACCESS_TOKEN",
        "ghcr.io/koki-develop/esa-mcp-server:latest"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

只读模式

要启用仅允许读取操作的只读模式,请添加--readonly标志。

使用npx:

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": [
        "-y",
        "@koki-develop/esa-mcp-server@latest",
        "--readonly"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

使用Docker:

{
  8"mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_TEAM",
        "-e",
        "ESA_ACCESS_TOKEN",
        "ghcr.io/koki-develop/esa-mcp-server:latest",
        "--readonly"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

在只读模式下,只有以下操作可用:

  • get_posts - 获取帖子列表
  • get_post - 获取特定帖子
  • get_tags - 获取标签
  • get_post_comments - 获取帖子评论

写入操作(如create_postupdate_postdelete_postcreate_post_commentupdate_commentdelete_comment)被禁用。

MCP工具

帖子

工具描述
get_posts从esa团队获取帖子列表。支持搜索查询、过滤、排序和分页。返回帖子元数据,包括标题、内容、标签、类别、作者信息和互动指标(评论、星标、关注)。可选地包含评论和星标者,支持嵌套包含如'comments,comments.stargazers'。注意:帖子内容(body_md)被截断到300个字符,并通过body_truncated字段指示是否发生截断,以减少上下文大小。
get_post根据帖子编号从esa团队获取特定帖子。返回完整的帖子详情,包括标题、内容(Markdown)、标签、类别、作者信息、修订历史和互动指标。可选地包含评论和星标者,支持嵌套包含如'comments,comments.stargazers'。
create_post在esa团队创建新帖子。需要标题,可选地接受内容、标签、类别、WIP状态和其他元数据。返回创建的帖子信息,包括分配的帖子编号和URL。
update_post更新esa团队中的现有帖子。需要帖子编号,可选地接受更新的内容、标签、类别、WIP状态和其他元数据。返回更新的帖子信息,包括修订详情。
delete_post删除esa团队中的现有帖子。需要帖子编号。该帖子将被永久删除且无法恢复。成功删除后返回确认消息。

标签

工具描述
get_tags获取esa团队中所有使用的标签列表。返回标签及其名称以及它们所附带的帖子数量,按帖子数量降序排列。支持分页。

评论

工具描述
get_post_comments获取特定帖子的评论列表。需要帖子编号并支持分页。返回评论元数据,包括内容、作者信息、时间戳和互动指标(星标)。
create_post_comment在esa团队的现有帖子上创建新的评论。需要帖子编号和Markdown格式的评论内容。返回创建的评论信息,包括ID、内容、时间戳和作者详情。
update_comment更新esa团队帖子上的现有评论。需要评论ID和新的Markdown格式内容。返回更新的评论信息,包括内容、时间戳和作者详情。
delete_comment删除esa团队中的现有评论。需要评论ID。该评论将被永久删除且无法恢复。成功删除后返回确认消息。

许可证

本项目根据MIT许可证授权 - 查看LICENSE文件以获取详细信息。

版权所有 (c) 2025 Koki Sato