Esa MCP Server Claude

🚀 ESA MCP 服务器

ESA MCP 服务器可将 esa.io 的数据以 Model Context Protocol (MCP) 格式提供，专为 Cloud Desktop 环境设计。

🚀 快速开始

安装步骤

# 代码库克隆
git clone https://github.com/sou-lab/esa-mcp-server-claude.git
cd esa-mcp-server-claude

# 依赖项安装
npm install

# CLI 执行权限赋予
chmod +x bin/cli.js

# 直接执行
node bin/cli.js

# 或者本地全局安装
npm install -g .

必要配置

首次启动时，需要输入以下信息：

• esa.io API 密钥
• esa.io 团队名称
• 服务器端口号（默认: 3000）

这些配置将保存到 ~/.esa-mcp-server/config.json 文件中。

📦 安装指南

安装步骤已在快速开始部分详细说明，可参考上述安装步骤进行操作。

💻 使用示例

基础用法

# 已安装的情况
esa-mcp-server

# 或者直接执行
node bin/cli.js

高级用法

API 端点

• GET / - 欢迎页面
• GET /mcp-data - 以 MCP 格式获取 ESA 的数据
• POST /search - 搜索 ESA 数据

搜索查询示例

curl -X POST http://localhost:3000/search \
  -H "Content-Type: application/json" \
  -d '{"query":"项目A"}'

Claude Desktop 中的设置

在 Claude Desktop 的 claude_desktop_config.json 中添加以下设置：

{
  "mcpServers": {
    "esa": {
      "command": "/path/to/node",
      "args": [
        "/path/to/esa-mcp-server-claude/bin/cli.js"
      ],
      "env": {
        "ESA_API_KEY": "你的ESA_API密钥",
        "ESA_TEAM_NAME": "你的团队名称",
        "PORT": "3000"
      }
    }
  }
}

各项目说明：

• command：Node 的路径（在 Mac/Linux 中可通过 which node 命令确认）
• args：CLI 脚本的路径
• env：环境变量（API 密钥、团队名称、端口号）

📄 许可证

本项目采用 ISC 许可证。