MCPServer + CoinGecko Wrapper

MCPServer + CoinGecko Wrapper

このリポジトリには、Model Context Protocol (MCP) を利用するための2つの主要なコンポーネントが含まれています。

---

1. mcpserver (PHP)

互換性のあるエージェントから MCP リクエストを受信し、応答するメインサーバーです。

主なファイル：

• core/：再利用可能なコアロジックです。
• capabilities.php：このサーバーが使用できるツールを宣言します。
• webhook.php：MCP リクエストを受信するメインエンドポイントです。

どのような機能ですか？

• MCP 形式（JSON）のリクエストを受信します。
• tool_choice に応じて内部で振り分けます。
• 該当するツール（たとえば、CoinGecko のラッパー）を呼び出します。
• エージェントが処理できるよう、構造化された MCP レスポンスを返します。

---

2. mcp-coingecko-wrapper (Node.js + TypeScript)

CoinGecko の公開 API を使用して暗号資産のデータを提供する外部ツールです。

構成：

• src/index.ts：ラッパーのメインロジックです。
• package.json：スクリプトと依存関係を定義します。

どのような機能ですか？

• MCP 互換の HTTP エンドポイントを公開します。
• 次のようなデータを取得できます：
  • 暗号資産の現在の価格。
  • 概要情報。
  • 価格履歴。

---

全体の仕組み

1. エージェント（Claude や GPT など）が MCP リクエストを送信します。
2. mcpserver の webhook.php がリクエストを受信し、使用するツールを決定します。
3. 暗号資産に関するリクエストの場合は、TypeScript のラッパー（mcp-coingecko-wrapper）を呼び出します。
4. CoinGecko のレスポンスを取得し、MCP 形式で返します。

---

要件

• PHP 8+ と curl のサポート（mcpserver 用）。
• Node.js 18+（ラッパー用）。
• MCP 互換のエージェントのインスタンス（例：Claude）。

---

クイックインストール

# 1. Instalar dependencias del wrapper
cd mcp-coingecko-wrapper
npm install
npm run build

# 2. Servir el mcpserver (PHP)
# Usar XAMPP, Apache o cualquier servidor PHP con acceso a webhook.php

---

📤 MCP リクエストの例

{
  "tool_choice": "coingecko",
  "input": {
    "symbol": "bitcoin",
    "operation": "price_now"
  }
}

これで完了です。MCP を使ってエージェントを CoinGecko に接続するために必要なものは以上です。