ESA API服务器

一个用于访问ESA API的MCP服务器,提供团队信息、文章管理、评论处理等功能。

  • by S-H-GAMELINKS
  • Ruby
  • 本地部署
  • 更新于
在 GitHub 查看 s-h-gamelinks/esa-mcp-server

使用说明

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」在本节中,单击新建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添加到配置文件

Cline在动态输入提示中单击esa_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:获取正在验证的用户信息

资源

以下资源可用:

  • 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>