esa MCP 服务器

用

概述

该服务器是一个使用模型上下文协议 (MCP) 的接口，使 Claude AI 能够与esa API进行交互。

通过此MCP服务器，Claude AI可以执行搜索、创建和更新esa文档等操作。

Related MCP server: MCP Expert Server

关于存储库

此存储库提供 esa MCP 服务器的独立实现。它将 Claude AI 与 esa 集成，以简化文档管理。

设置

先决条件

Node.js 18 或更高版本
esa API访问令牌
欧空局团队名称

安装

# Install globally
npm install -g @kajirita2002/esa-mcp-server

# Or use directly with npx
npx @kajirita2002/esa-mcp-server

设置环境变量

# Set environment variables
export ESA_ACCESS_TOKEN="your_esa_access_token"
export ESA_TEAM="your_team_name"

MCP 配置示例

如果您使用此 MCP 服务器，请将以下配置添加到您的mcp_config.json文件中：

"esa": {
  "command": "npx",
  "args": ["-y", "@kajirita2002/esa-mcp-server"],
  "env": {
    "ESA_ACCESS_TOKEN": "your_esa_access_token",
    "ESA_TEAM": "your_team_name"
  }
}

启动服务器

# Start the server
npm start

可用工具

该 MCP 服务器提供以下工具：

评论相关

esa_list_comments
- 获取帖子的评论列表
- 输入：
  - post_number （数字，必填）：获取评论的帖子编号
  - page （数字，可选）：要检索的页码
  - per_page （数字，可选）：每页结果数（最大值：100）
esa_get_comment
- 获得具体评论
- 输入：
  - comment_id （数字，必填）：要检索的评论的 ID
  - include （字符串，可选）：响应中包含的相关数据（例如“stargazers”）
esa_create_comment
- 对文章发表评论
- 输入：
  - post_number （数字，必填）：要评论的帖子编号
  - body_md (字符串，必需)：评论正文（Markdown 格式）
  - user （字符串，可选）：发布者的屏幕名称（只有团队所有者可以指定）

会员相关

esa_get_members
- 获取团队成员列表
- 输入：
  - page （数字，可选）：要检索的页码
  - per_page （数字，可选）：每页结果数（最大值：100）
esa_get_member
- 获取有关特定团队成员的信息
- 输入：
  - screen_name_or_email （字符串，必需）：要检索的成员的屏幕名称或电子邮件

使用示例

以下是 Claude 使用此 MCP 服务器创建 esa 帖子的示例：

[Claude] Please create a new post in esa. The title should be "Project X Progress Report" and the body should include "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C".

[MCP Server] Using the esa_create_post tool to create a new post.

[Result]
{
  "number": 123,
  "name": "Project X Progress Report",
  "body_md": "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C",
  "wip": false,
  "created_at": "2023-06-01T12:34:56+09:00",
  "updated_at": "2023-06-01T12:34:56+09:00",
  "url": "https://your-team.esa.io/posts/123"
}

[Claude] The post has been created successfully. The post number is 123, and you can access it at the following URL:
https://your-team.esa.io/posts/123

故障排除

访问令牌问题

Error: Request failed with status code 401

如果您看到此错误，则您的 ESA 访问令牌可能无效或已过期。请从 ESA 设置屏幕生成新的访问令牌并更新您的环境变量。

权限问题

Error: Request failed with status code 403

如果看到此错误，则表示当前访问令牌没有必要的权限。请在 esa 设置屏幕中检查访问令牌的权限，并根据需要颁发新的令牌。

执照

根据 MIT 许可提供。

esa MCP Server