CoinGecko MCP について
CoinGecko MCP は、CoinGecko が提供する暗号資産の価格と市場データ向けの公式 MCP サーバーです。エージェントが TypeScript SDK 向けのコードを書き、サンドボックスで実行する Code Mode を採用しています。ローカルとリモートのどちらでも動作します。
主な機能
- 01TypeScript SDK を呼び出す Code Mode ツール
- 02ドキュメント検索ツール
- 03Deno サブプロセス内での制限付きコード実行
- 04Streamable HTTP によるリモート実行
- 05ヘッダーまたは環境変数による API キーの指定
活用シーン
- 01暗号資産の価格と市場データの照会
- 02エージェントによる複数段階のデータ分析
- 03チーム向けのリモートサーバーとしての運用
MCP 対応
本プロジェクトは MCP サーバーであり、ドキュメント検索ツールと CoinGecko SDK を呼び出すコード実行ツールの 2 つを MCP クライアントに公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
3掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| endpoint | string | はい | スキーマを取得するエンドポイントの名前。 |
詳細
Coingecko TypeScript MCP サーバー
Stainless を使用して生成されています。
インストール
直接実行
npx を使って MCP サーバーを直接実行できます。
export COINGECKO_PRO_API_KEY="My Pro API Key"
export COINGECKO_DEMO_API_KEY="My Demo API Key"
export COINGECKO_ENVIRONMENT="pro"
npx -y @coingecko/coingecko-mcp@latest
MCP クライアント経由
既存のクライアントの一部が modelcontextprotocol.io に掲載されています。すでに クライアントをお持ちの場合は、MCP サーバーのインストール方法について、そのドキュメントをご確認ください。
設定 JSON を使用するクライアントでは、次のような形式になります。
{
"mcpServers": {
"coingecko_api": {
"command": "npx",
"args": ["-y", "@coingecko/coingecko-mcp"],
"env": {
"COINGECKO_PRO_API_KEY": "My Pro API Key",
"COINGECKO_DEMO_API_KEY": "My Demo API Key",
"COINGECKO_ENVIRONMENT": "pro"
}
}
}
}
Cursor
Cursor をお使いの場合は、下のボタンを使って MCP サーバーをインストールできます。Cursor Settings > Tools & MCP > New MCP Server にある Cursor の mcp.json で、
環境変数を設定する必要があります。
VS Code
MCP をお使いの場合は、下のリンクをクリックして MCP サーバーをインストールできます。VS Code の Command Palette > MCP: Open User Configuration から開ける mcp.json で、
環境変数を設定する必要があります。
Claude Code
Claude Code をお使いの場合は、ターミナルで下のコマンドを実行して MCP サーバーをインストールできます。ホームディレクトリにある Claude Code の .claude.json で、
環境変数を設定する必要があります。
claude mcp add coingecko_coingecko_mcp_api --env COINGECKO_PRO_API_KEY="My Pro API Key" COINGECKO_DEMO_API_KEY="My Demo API Key" -- npx -y @coingecko/coingecko-mcp
コードモード
この MCP サーバーは「Code Mode」ツールスキームを採用しています。この MCP サーバーでは、 エージェントが TypeScript SDK を使ってコードを記述し、そのコードがサンドボックス内で実行されます。これを実現するため、サーバーはエージェントに次の 2 つのツールを公開します。
-
1 つ目はドキュメント検索ツールです。API/SDK のドキュメントを一般的に検索するために使用できます。
-
2 つ目はコードツールです。エージェントはこのツールで TypeScript SDK を使ったコードを記述できます。 コードは、ファイルシステムとネットワークへのアクセスが SDK の必要範囲に制限されたサンドボックス内で実行されます。詳しくは下記の「コードの実行場所」をご覧ください。コードが返す、または出力する内容はすべて、 ツール呼び出しの結果としてエージェントに返されます。
このスキームにより、エージェントは非常に複雑なタスクを決定論的かつ再現可能な方法で実行できます。
コードの実行場所
このサーバーはローカルでコードを実行します。コードツールの各呼び出しは、MCP サーバーと同じマシン上の Deno サブプロセスで実行されます。アクセスはサーバー自身のファイルの読み取りと、API ホストへのネットワークリクエストに制限されます。
コードツールを動作させるには Deno がインストールされている必要があります。https://deno.land からインストールするか、
npm install deno で MCP サーバーの依存関係に追加してください。
リモートでの実行
クライアントを --transport=http で起動すると、Streamable HTTP トランスポートを使うリモートサーバーとしてサーバーが起動します。--port 設定で実行ポートを選択でき、--socket 設定を使うと Unix ソケットで実行できます。
認証には次のヘッダーを使用できます。
| ヘッダー | 対応するクライアントオプション | セキュリティスキーム |
|---|---|---|
x-cg-pro-api-key | proAPIKey | proKeyAuth |
x-cg-demo-api-key | demoAPIKey | demoKeyAuth |
サーバーが http://localhost:3000 でホストされている場合、このサーバーの設定 JSON は次のようになります。
{
"mcpServers": {
"coingecko_coingecko_typescript_api": {
"url": "http://localhost:3000",
"headers": {
"x-cg-pro-api-key": "My Pro API Key"
}
}
}
}
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。