ESA MCP 服务器

这是一个用于访问 esa API 的 MCP 服务器。

功能

此 MCP 服务器使用 esa API 提供以下功能：

• 获取团队信息
• 获取文章列表
• 获取文章详情
• 创建文章
• 更新文章
• 获取评论列表
• 创建评论
• 获取团队统计信息
• 获取成员列表
• 获取标签列表
• 获取分类信息
• 获取已认证用户信息

设置

1. 安装依赖

bundle install

2. 获取 esa 访问令牌

1. 登录 esa
2. 访问用户设置页面 (https://[team].esa.io/user/applications)
3. 在 "Personal access tokens" 部分点击 "New Token"
4. 输入令牌名称并选择作用域（建议同时选择 read/write）
5. 点击 "Create" 按钮
6. 复制生成的访问令牌

3. 配置 MCP 服务器

在 esm-mcp-server 目录下，通过环境变量设置访问令牌和团队名称。

然后，如下修改 Cline 的 MCP 配置文件：

{
  "mcpServers": {
    "esa": {
      "command": "ruby",
      "args": ["/path/to/esa_mcp_server.rb"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

4. 添加到 Cline 配置文件

将 esa_mcp_settings.json 的内容添加到 Cline 的配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json
• VSCode 扩展: ~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

使用方法

工具

可以使用以下工具：

• get_team: 获取团队信息
• list_posts: 获取文章列表
• get_post: 获取文章详情
• create_post: 创建文章
• update_post: 更新文章
• list_comments: 获取文章的评论列表
• create_comment: 创建评论
• get_stats: 获取团队统计信息
• list_members: 获取成员列表
• list_tags: 获取标签列表
• get_user: 获取已认证用户信息

资源

可以使用以下资源：

• categories://{category_name}: 获取分类信息

示例

获取团队信息

<use_mcp_tool>
<server_name>esa</server_name>
<tool_name>get_team</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

获取文章列表

<use_mcp_tool>
<server_name>esa</server_name>
<tool_name>list_posts</tool_name>
<arguments>
{
  "q": "category:开发",
  "page": 1,
  "per_page": 20,
  "sort": "updated",
  "order": "desc"
}
</arguments>
</use_mcp_tool>

创建文章

<use_mcp_tool>
<server_name>esa</server_name>
<tool_name>create_post</tool_name>
<arguments>
{
  "name": "新的文章",
  "body_md": "# 新的文章\n\n这是新的文章。",
  "tags": ["标签1", "标签2"],
  "category": "开发/Ruby",
  "wip": true,
  "message": "创建新的文章"
}
</arguments>
</use_mcp_tool>

获取分类信息

<access_mcp_resource>
<server_name>esa</server_name>
<uri>categories://开发</uri>
</access_mcp_resource>