Valyu MCP Server

Valyu MCP サーバー

Valyu MCP サーバーは、AI モデルが Valyu の API から高品質なコンテキストを取得できるようにする Model Context Protocol（MCP）ツールです。Wikipedia、arXiv の論文（金融、研究などに最適）、ウェブ検索を対象とした包括的な検索機能を備えています。

前提条件

MCP サーバーをセットアップする前に、以下がそろっていることを確認してください。

1. Python 3.10+
2. Claude Desktop（最新バージョン）
3. Valyu API キー（Valyu Exchangeから取得できます）

Python のバージョンを確認するには、次を実行します。

python --version

インストールと設定

オプション 1：自動セットアップ（推奨）

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

git clone https://github.com/ValyuNetwork/valyu-mcp.git
cd valyu-mcp

2. セットアップスクリプトを実行します

chmod +x setup.sh  
./setup.sh       

セットアップスクリプトでは、以下が実行されます。

• 仮想環境を作成して有効化します
• すべての依存関係をインストールします
• Valyu API キーの入力を求めます
• 必要な .env ファイルを作成します
• Claude Desktop の設定を更新する手順を提示します

オプション 2：手動セットアップ

手動でセットアップする場合、または自動セットアップが環境で動作しない場合は、以下の手順に従ってください。

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

git clone https://github.com/ValyuNetwork/valyu-mcp.git
cd valyu-mcp

2. 仮想環境を作成して有効化します

python -m venv .venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate    # Windows

3. 依存関係をインストールします

pip install -r requirements.txt

4. プロジェクトのルートに .env ファイルを作成します。

echo "VALYU_API_KEY=your-api-key-here" > .env

5. Claude Desktop の設定ファイルを開いて編集します。

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

   設定ファイルが存在しない場合：

   1. Claude Desktop を開きます
   2. Settings に移動します
   3. Developer タブで Developer Mode を有効にします
   4. 設定ファイルが自動的に生成されます

   このファイルは、次のコマンドで VS Code から開けます。

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json  # macOS
   code %APPDATA%\Claude\claude_desktop_config.json  # Windows (PowerShell)
   

6. mcpServers の下に次のエントリを追加します。

{
  "mcpServers": {
    "valyu-mcp": {
      "command": "/ABSOLUTE/PATH/TO/.venv/bin/python",
      "args": ["-u", "/ABSOLUTE/PATH/TO/valyu-mcp.py"],
      "env": {
        "VALYU_API_KEY": "your-api-key-here"
      }
    }
  }
}

MCP サーバーの実行

1. サーバーを手動で起動します（テスト用）。

python valyu-mcp.py

2. Claude Desktop を起動し、MCP ツールが認識されていることを確認します。
   • Claude のインターフェースで valyu-mcp ツールを探します。
   • Claude でクエリを試します（例：「強化学習に関する最新の論文を教えてください」）。

テストとデバッグ

問題が発生した場合は、ログを確認してください。

tail -n 20 -F ~/Library/Logs/Claude/mcp*.log  # macOS

Get-Content $env:APPDATA\Claude\Logs\mcp_valyu-mcp.log -Wait  # Windows

トラブルシューティング

• ModuleNotFoundError：スクリプトを実行する前に、仮想環境が有効になっていることを確認してください。
• サーバーが起動しない：claude_desktop_config.json 内のパスを確認してください。
• Valyu API から結果が返されない：API キーが有効で、クレジットが残っていることを確認してください。

無料クレジットと API アクセス

Valyu Exchange に登録し、Valyu API を MCP サーバーでテストするための10 ドル分の無料クレジットを獲得してください。

コントリビューション

プルリクエストを歓迎します。バグ報告や機能リクエストがあれば、お気軽に issue を作成してください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。

---

Valyu で開発中の内容について詳しくは、valyu.networkをご覧ください。 ブログもご覧ください。