Web3 Research MCP

ローカルで実行する MCP サーバーから、暗号資産を詳しく調査できます。
検索とデータリクエストは外部プロバイダーに送信され、ページ取得ツールは指定された URL にアクセスします。調査状況と保存したリソースはローカルに保存されます。公開ソースの利用に API キーは必要ありません。

スターをお願いします ❤️ →        

## 🚀 プレビュー

🧠 機能

• 包括的な調査：あらゆる暗号資産トークンについて詳細な情報を収集します
• 複数ソースの分析：CoinGecko、CoinMarketCap、DeFiLlama など、複数のソースを横断して調査します
• 構造化されたレポート：技術的な基礎、マーケットデータ、ソーシャルセンチメントなどを網羅した詳細なレポートを生成します
• リソース管理：検索結果とコンテンツを参照用に自動保存します
• ステータス追跡：さまざまな段階やセクションにわたって調査の進捗を追跡します

📋 要件

• Node.js 18 以上

🔧 インストールとセットアップ

Smithery 経由でインストールする

Smithery 経由で Claude Desktop に web3-research-mcp を自動的にインストールするには：

npx -y @smithery/cli install web3-research-mcp --client claude

🔌 Claude Desktop で使用する

Claude Desktop の設定ファイルを編集します

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop の設定ファイルに次の内容を追加します：

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

その後、Claude Desktop を再起動します

🔌 Claude Code で使用する

claude mcp add web3-research-mcp -- npx -y web3-research-mcp@latest

🔌 Cursor で使用する

次の場所に移動します：設定 -> Cursor の設定 -> MCP -> 新しいグローバル MCP サーバーを追加 これを Cursor の ~/.cursor/mcp.json ファイルに貼り付けます。詳しくは Cursor MCP のドキュメントをご覧ください。

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

その後、Cursor を再起動します

🧩 ソースから実行する

git clone https://github.com/aaronjmars/web3-research-mcp.git
cd web3-research-mcp
npm ci
npm run build
npm start   # MCP server over stdio

クライアントからローカルビルドを指定するには、"command": "node" と "args": ["/path/to/web3-research-mcp/dist/server.js"] を使用します。

⚙️ 設定

API キーは必要ありません。任意の環境変数が 1 つあります：

• COINGECKO_API_KEY：CoinGecko Pro キーです。設定されていない場合は、無料の公開 API が使用されます。

🛠️ ツール

create-research-plan

トークンの構造化された調査計画を作成します。

パラメーター：

• tokenName：トークンの正式名称
• tokenTicker：トークンのティッカーシンボル

search

ウェブ検索を実行し、結果を返します。

パラメーター：

• query：検索クエリ
• searchType：検索の種類（ウェブ、ニュース、画像、動画）

research-with-keywords

特定のキーワードを使ってトークンを検索し、結果を保存します。

Parameters:

• tokenName: トークン名
• tokenTicker: ティッカーシンボル
• keywords: 検索するキーワードの配列

update-status

調査セクションのステータスを更新します。

Parameters:

• section: 更新するセクション名（例：'projectInfo'、'technicalFundamentals'）
• status: セクションの新しいステータス（planned、in_progress、completed）

fetch-content

URLからコンテンツを取得し、リソースとして保存します。

Parameters:

• url: コンテンツを取得するURL
• format: 出力形式（text、html、markdown、json）

list-resources

保存されている利用可能なリソースをすべて一覧表示します。

search-source

特定のソースからトークンに関する情報を検索します。

Parameters:

• tokenName: トークン名
• tokenTicker: ティッカーシンボル
• source: 検索するソース（例：'CoinGecko'、'DeFiLlama'、'News'）

research-source

特定のソースでトークンを検索し、最上位の検索結果のページコンテンツをMarkdownリソースとして保存します。

Parameters:

• tokenName: トークン名
• tokenTicker: トークンのティッカーシンボル
• source: 調査するソース（例：'IQ Wiki'、'CoinMarketCap'）

coingecko-data

CoinGeckoの公開APIから市場データを直接取得します。価格、時価総額、24時間／7日／30日の変動率、ATH／ATL、流通供給量、各チェーンのコントラクトアドレス、ソーシャル／開発リンクが含まれます。HTMLスクレイピングで発生する403の問題を回避します。

Parameters:

• tokenName: トークンの正式名称（例：'Bitcoin'）
• tokenTicker: ティッカーシンボル（例：'BTC'）

APIキーは不要です。無料の公開ティアを使用します（約30 req/min）。

オプション：環境変数に COINGECKO_API_KEY を設定すると、CoinGecko Pro APIキーを使用できます。設定すると、x-cg-pro-api-key ヘッダーを付けて https://pro-api.coingecko.com/api/v3 にリクエストを送信します。リクエストは15sでタイムアウトします。

coingecko-search

CoinGeckoのコインインデックスを検索し、CoinGecko IDを含む候補を返します。ティッカーが曖昧な場合（例：同じシンボルを持つトークンが複数ある場合）に便利です。

Parameters:

• query: 検索クエリ：名前、ティッカー、またはコントラクトアドレス

coingecko-tickers

CoinGeckoからトークンのアクティブな取引所上場情報を取得します。どのCEX／DEXでその取引ペアが取引されているか、取引所ごとの24時間のUSD取引高、最終価格、買値と売値のスプレッド、信頼スコア、取引URLが含まれます。24時間のUSD取引高の降順で並べ替えられ、異常値や古い価格情報は除外されます。「このトークンは実際にどこで取引されているか」という質問に対して、HTMLスクレイピングを回避します。

Parameters:

• tokenName: トークンの正式名称（例：'Bitcoin'）
• tokenTicker: ティッカーシンボル（例：'BTC'）
• limit: 返す上位取引所の数（デフォルト15、最大50）

APIキーは不要です。無料の公開ティアを使用します。リクエストは15sでタイムアウトします。

defillama-data

DeFiLlamaの公開APIからプロトコルデータを直接取得します。TVL合計、ATH時のTVLと日付、現在と比較した30／90／365日間のTVL変動率、時価総額（利用可能な場合。DeFiLlamaでは多くのプロトコルで省略されています）、チェーンごとのTVL内訳、手数料（24時間／7日／30日／全期間）、トークンアドレス、資金調達ラウンド、リンクが含まれます。一般的なDeFiプロトコルの検索でHTMLスクレイピングを回避します。

Parameters:

• tokenName: プロトコル／トークンの正式名称（例：'Uniswap'）
• tokenTicker: ティッカーシンボル（例：'UNI'）

APIキーは不要です。無料の公開APIを使用します。リクエストは15sでタイムアウトします。呼び出しのたびに/protocolsへ過剰なリクエストを送信しないよう、プロトコルインデックスはプロセスごとに5分間キャッシュされます。

defillama-search

DeFiLlamaのプロトコルインデックスを検索し、スラッグ、TVL、カテゴリを含む候補を返します。ティッカーが曖昧な場合（例：似た名前のプロトコルが複数ある場合）に便利です。

Parameters:

• query: 検索クエリ：プロトコル名、ティッカー、またはスラッグ

📝 プロンプト

token-research

暗号資産トークンの包括的な調査を開始します。

Parameters:

• tokenName: 暗号資産トークンの正式名称
• tokenTicker: トークンのティッカーシンボル（例：BTC、ETH）

🧠 動作の仕組み

1. 調査を開始すると、トークンのあらゆる側面を網羅する構造化された計画が作成されます
2. サーバーが複数の情報源を検索して情報を収集します
3. 検索結果は、参照可能なリソースとして保存されます
4. ステータスを追跡しながら、調査を複数のセクションに分けて進めます
5. トークンのあらゆる側面を網羅する包括的なレポートが生成されます

⚠️ 制限事項

• ウェブサイトによってはウェブスクレイピングがブロックされるため、コンテンツを直接取得しようとすると403エラーが発生する場合があります
• 検索結果に依存するため、情報が必ずしも網羅的とは限りません
• 検索操作にはレート制限が適用される場合があります

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳しくはLICENSEファイルをご覧ください。

---

AeonとMiroSharkの創設者、Aaron Elijah Marsが開発 · @aaronjmars