esa MCP 服务器

<img width="775" alt="スクリーンショット 2025-03-27 午後1 14 09" src="https://github.com/user-attachments/assets/e5f8f308-ed7a-4774-b3a3-9cc284ea7422" />

阅读 日语

概述

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

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

<a href="https://glama.ai/mcp/servers/@kajirita2002/esa-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@kajirita2002/esa-mcp-server/badge" alt="esa Server MCP server" /> </a>

关于此仓库

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

设置

前提条件

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

安装

# 全局安装
npm install -g @kajirita2002/esa-mcp-server

# 或者直接使用 npx
npx @kajirita2002/esa-mcp-server

设置环境变量

# 设置环境变量
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"
  }
}

启动服务器

# 启动服务器
npm start

可用工具

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

文章相关

1. esa_list_posts

   • 获取团队中的文章列表
   • 输入：
     • q (字符串，可选): 搜索查询
     • include (字符串，可选): 要包含在响应中的相关数据 (例如 'comments,stargazers')
     • sort (字符串，可选): 排序方法 (updated, created, number, stars, watches, comments, best_match)
     • order (字符串，可选): 排序顺序 (desc, asc)
     • per_page (数字，可选): 每页的结果数 (最大值: 100)
     • page (数字，可选): 要检索的页码

2. esa_get_post

   • 获取有关特定文章的详细信息
   • 输入：
     • post_number (数字，必需): 要检索的文章编号
     • include (字符串，可选): 要包含在响应中的相关数据 (例如 'comments,stargazers')

3. esa_create_post

   • 创建新文章
   • 输入：
     • name (字符串，必需): 文章标题
     • body_md (字符串，可选): 文章正文 (Markdown 格式)
     • tags (字符串数组，可选): 文章的标签列表
     • category (字符串，可选): 文章类别
     • wip (布尔值，可选，默认值: true): 是否标记为 WIP (Work In Progress)
     • message (字符串，可选): 更改消息
     • user (字符串，可选): 发布者的 screen_name (只有团队所有者可以指定)
     • template_post_id (数字，可选): 用作模板的文章 ID

4. esa_update_post

   • 更新现有文章
   • 输入：
     • post_number (数字，必需): 要更新的文章编号
     • name (字符串，可选): 文章的新标题
     • body_md (字符串，可选): 文章的新正文 (Markdown 格式)
     • tags (字符串数组，可选): 文章的新标签列表
     • category (字符串，可选): 文章的新类别
     • wip (布尔值，可选): 是否标记为 WIP (Work In Progress)
     • message (字符串，可选): 更改消息
     • created_by (字符串，可选): 发布者的 screen_name (只有团队所有者可以指定)
     • original_revision (字符串，可选): 基于其进行更新的版本

评论相关

1. esa_list_comments

   • 获取文章的评论列表
   • 输入：
     • post_number (数字，必需): 获取评论的文章编号
     • page (数字，可选): 要检索的页码
     • per_page (数字，可选): 每页的结果数 (最大值: 100)

2. esa_get_comment

   • 获取特定评论
   • 输入：
     • comment_id (数字，必需): 要检索的评论 ID
     • include (字符串，可选): 要包含在响应中的相关数据 (例如 'stargazers')

3. esa_create_comment

   • 向文章发表评论
   • 输入：
     • post_number (数字，必需): 要评论的文章编号
     • body_md (字符串，必需): 评论正文 (Markdown 格式)
     • user (字符串，可选): 发布者的 screen_name (只有团队所有者可以指定)

成员相关

1. esa_get_members

   • 获取团队成员列表
   • 输入：
     • page (数字，可选): 要检索的页码
     • per_page (数字，可选): 每页的结果数 (最大值: 100)

2. esa_get_member

   • 获取有关特定团队成员的信息
   • 输入：
     • screen_name_or_email (字符串，必需): 要检索的成员的屏幕名称或电子邮件

使用示例

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

[Claude] 请在 esa 中创建一个新文章。标题应为“Project X Progress Report”，正文应包括“# 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] 使用 esa_create_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] 文章已成功创建。文章编号为 123，您可以通过以下 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 许可证下提供。