Esa MCP Server Claude

🚀 ESA MCP 服务器

ESA MCP 服务器可将 esa.io 的数据以 Model Context Protocol (MCP) 格式提供，专为 Cloud Desktop 环境设计，能为相关应用提供便捷的数据支持。

🚀 快速开始

本服务器能将 esa.io 的数据以 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 许可证。