🚀 Valyu MCP 服務器

Valyu MCP 服務器是一款模型上下文協議（MCP）工具，它能讓人工智能模型通過 Valyu 的 API 獲取高質量的上下文信息。該工具具備對 Wikipedia、arXiv 論文（在金融和研究領域十分適用）以及網絡搜索的全文檢索功能。

🚀 快速開始

在使用 Valyu 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 服務器

要運行 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 網站 或聯繫支持團隊。