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 許可證。