Crypto Whitepapers MCP Server

Crypto Whitepapers MCP Server

AI エージェントがアクセス、分析、学習できるよう、暗号資産のホワイトペーパーを体系化したナレッジベースを提供する MCP サーバーです。

機能

• ホワイトペーパーの検索：DuckDuckGo を使用して、暗号資産プロジェクトのホワイトペーパー PDF を検索します。
• ホワイトペーパーの読み込み：ホワイトペーパー PDF をダウンロードし、ナレッジベースにインデックス化します。
• ナレッジベースへの問い合わせ：プロジェクトによる絞り込みを任意で指定して、ホワイトペーパーの内容を検索します。
• プロジェクトの一覧表示：ナレッジベースで利用できるすべてのプロジェクトを表示します。
• Claude Desktop との統合：MCP 経由で Claude Desktop からツールやプロンプトにアクセスできます。

前提条件

• Python 3.10+
• 依存関係の管理と実行に使用する uv
• インターネット接続
• MCP 統合用の Claude Desktop（任意）

セットアップ

1. リポジトリをクローンします：

   git clone https://github.com/kukapay/crypto-whitepapers-mcp.git
   cd crypto-whitepapers-mcp
   

2. uv で依存関係をインストールします：

   uv sync
   

3. Claude Desktop と統合します（任意）：

   • Claude Desktop の設定ファイルを編集します：
     • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
     • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • 次の設定を追加します：

     {
         "mcpServers": {
             "crypto-whitepapers": {
                 "command": "uv",
                 "args": [
                     "--directory",
                     "/absolute/path/to/crypto-whitepapers-mcp"   
                     "run",
                     "crypto-whitepapers-mcp"
                 ]
             }
         }
     }
     

     /absolute/path/to/crypto-whitepapers-mcp をリポジトリの絶対パスに置き換えてください。
   • Claude Desktop を再起動し、サーバーが読み込まれていることを確認します（入力欄にハンマーアイコンが表示されているか確認してください）。

使い方

ツール

MCP サーバーでは、次のツールを利用できます：

• list_available_projects()：ナレッジベース内のすべてのプロジェクトを一覧表示します（PDF のファイル名から取得）。

  • 例：list_available_projects()
  • 戻り値：プロジェクト名の JSON リスト。

• search_whitepaper(project_name: str)：DuckDuckGo を使用して、プロジェクトのホワイトペーパー PDF を検索します。

  • 例：search_whitepaper("bitcoin")
  • 戻り値：タイトル、URL、概要を含む、最大 5 件の結果の JSON リスト。

• load_whitepaper(project_name: str, url: str)：URL からホワイトペーパー PDF をダウンロードし、ナレッジベースに読み込みます。

  • 例：load_whitepaper("bitcoin", "https://bitcoin.org/bitcoin.pdf")
  • 戻り値：成功またはエラーメッセージ。

• ask_whitepapers(query: str, project_name: str = None)：任意でプロジェクトを指定して絞り込み、クエリに該当する内容をナレッジベースから検索します。

  • 例：ask_whitepapers("blockchain technology", "bitcoin")
  • 戻り値：一致するテキストスニペットを最大 5 件返します。

プロンプト

• analyze_tokenomics(project_name: str)：ask_whitepapers ツールを使用して、プロジェクトのホワイトペーパーに記載されたトークノミクス（分配、供給量、インセンティブ）を分析します。
  • 例：Claude Desktop で「Ethereum のトークノミクスを分析してください。」を実行します。

例

1. 利用可能なプロジェクトを一覧表示します：

   List all available projects.
   

2. ホワイトペーパーを検索します：

   Search for the Bitcoin whitepaper PDF.
   

3. ホワイトペーパーを読み込みます：

   Load the Bitcoin whitepaper from https://bitcoin.org/bitcoin.pdf.
   

4. ナレッジベースに問い合わせます：

   Ask the knowledge base about blockchain technology in the Bitcoin whitepaper.
   

ライセンス

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