ESA MCP 服务器

这是一个用于通过esa API提供服务的MCP服务器。

功能

该MCP服务器使用esa的API实现以下功能：

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

设置步骤

1. 安装依赖项

在终端中运行以下命令：

bundle install

2. 获取esa的访问令牌

按照以下步骤获取访问令牌：

1. 登录到esa
2. 访问用户设置页面（https://[团队名].esa.io/user/applications）
3. 点击“Personal access tokens”部分中的“New Token”
4. 输入令牌名称并选择权限范围（推荐同时选择read和write权限）
5. 点击“Create”按钮
6. 复制生成的访问令牌

3. 配置MCP服务器

在esa_mcp_server.rb文件所在的目录中，通过环境变量设置访问令牌和团队名。随后，在Cline的MCP配置文件中添加以下内容：

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

4. 将配置添加到Cline设置文件

根据你的操作系统或IDE，将以下路径中的claire_mcp_settings.json内容进行更新：

• 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_info: 获取认证用户信息

示例

示例1: 获取团队信息

<access_mcp_resource>
  <server_name>esa</server_name>
  <uri>teams://[team-name]</uri>
</access_mcp_resource>

示例2: 创建新文章

<invoke_mcp_tool>
  <tool_name>create_post</tool_name>
  <parameters>
    <title>我的新文章</title>
    <content>这是我的第一篇文章。</content>
  </parameters>
</invoke_mcp_tool>

示例3: 获取分类信息

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

以上是完整的中文翻译，涵盖了原文的所有内容。