ESA MCP Server

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 - 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