MCP esa

MCP ESA服务器

用于esa.io API集成的模型上下文协议（MCP）服务器。使Claude Desktop和其他MCP客户端能够与esa.io团队、帖子、评论和成员进行交互。

安装

来自GitHub

# Clone the repository
git clone https://github.com/iberianpig/mcp_esa.git
cd mcp_esa

# Make the script executable
chmod +x mcp_esa.rb

直接下载

# Download the single file
curl -O https://raw.githubusercontent.com/iberianpig/mcp_esa/main/mcp_esa.rb
chmod +x mcp_esa.rb

设置

环境变量

export ESA_ACCESS_TOKEN="your_token_here"
export ESA_TEAM_NAME="your_team_name"

MCP配置

使用Claude Code命令行界面（推荐）

# Add as local configuration (default)
claude mcp add --transport stdio \
  --env ESA_ACCESS_TOKEN=$ESA_ACCESS_TOKEN \
  --env ESA_TEAM_NAME=your_team_name \
  esa -- ruby /absolute/path/to/mcp_esa.rb

# Add for project sharing (saves to .mcp.json)
claude mcp add --transport stdio --scope project \
  --env ESA_ACCESS_TOKEN=$ESA_ACCESS_TOKEN \
  --env ESA_TEAM_NAME=your_team_name \
  esa -- ruby /absolute/path/to/mcp_esa.rb

选项：

• --transport stdio：作为本地进程运行
• --scope：保存配置的位置(local=个人， project=团队共享， user=跨项目）
• --env KEY=value：设置环境变量（可以指定多个）

管理命令：

claude mcp list          # List all servers
claude mcp get esa       # Show server details
claude mcp remove esa    # Remove a server

手册 .mcp.json 配置

{
  "mcpServers": {
    "esa": {
      "command": "ruby",
      "args": ["/path/to/mcp_esa/mcp_esa.rb"]
    }
  }
}

用法

使用克劳德桌面

Show me the latest posts from esa.io

Create a new post titled "Meeting Notes"

Show comments for post #123

命令行测试

echo '{"jsonrpc":"2.0","id":0,"method":"tools/list"}' | ./mcp_esa.rb

列出带有过滤和分页功能的帖子：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_posts_tool","arguments":{}}}' | ./mcp_esa.rb

可用工具

帖子

• get_posts_tool -列出带有过滤和分页功能的帖子
• get_post_tool -获取详细的帖子信息
• create_post_tool -创建新帖子
• update_post_tool -更新现有帖子

团队

• get_teams -列出您所属的团队
• get_team -获取团队详细信息
• get_members -列出团队成员

评论

• get_comments -列出帖子的评论
• create_comment -添加新评论