🚀 Valyu MCP サーバー

Valyu MCP サーバーは、モデルコンテキストプロトコル（MCP）ツールです。これにより、人工知能モデルは Valyu の API を通じて、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. 設定に移動する
3. 開発者タブで開発者モードを有効にする
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": [],
      "env": {}
    }
  }
}

💻 使用例

基本的な使用法

MCP サーバーを実行するには、Valyu ドキュメント を参照してください。

高度な使用法

インストールの検証

1. すべての依存関係が正しくインストールされていることを確認する
2. 仮想環境をアクティブ化する（該当する場合）
3. 以下のコマンドを実行して MCP サーバーを起動する

python -m valyu.mcp_server

デバッグログ

コンソール出力を確認して、エラーや警告メッセージを確認してください。API キーが正しく有効であることを確認してください。

🔧 トラブルシューティング

• 問題：Valyu サービスに接続できない
  • 解決策：ネットワーク接続を確認し、API キーが有効であることを確認し、Valyu ステータスページ を参照する
• 問題：設定ファイルが見つからない
  • 解決策：設定ファイルのパスが正しいことを確認し、サーバーを再起動する

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

Valyu Free Credits にアクセスして、無料クレジットを取得し、MCP サービスの使用を開始してください。

🤝 貢献ガイド

貢献するには、Valyu 開発ドキュメント を参照し、GitHub リポジトリ にプルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT License に基づいています。

参考文献

• Valyu ドキュメント
• Claude Desktop 設定ガイド
• 開発者ドキュメント

詳細情報が必要な場合は、Valyu ウェブサイト にアクセスするか、サポートチームにお問い合わせください。