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 / - ライ welcome ページ
• GET /mcp-data - ESA のデータを MCP 形式で取得
• 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