Esa MCP Server Claude

🚀 ESA MCP サーバー

このサーバーは、esa.io のデータを Model Context Protocol (MCP) 形式で提供します。Cloud Desktop 環境に最適化されています。

🚀 クイックスタート

このサーバーを使用することで、esa.io のデータを MCP 形式で簡単に取得できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• esa.io のデータを MCP 形式で提供します。
• Cloud Desktop 環境に最適化されています。
• API エンドポイントを通じてデータの取得や検索が可能です。

📦 インストール

# コードリポジトリのクローン
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