Valyu MCP Server

Valyu MCP Server 是一个模型上下文协议（MCP）工具，它使AI模型能够从Valyu的API中检索高质量的上下文信息，包括维基百科、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": ["-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注册并领取10美元免费信用以测试Valyu API与MCP服务器。

贡献

欢迎提交拉取请求！对于错误报告或功能请求，随时可以打开一个issue。

许可证

本项目采用MIT许可证。

---

更多关于我们在Valyu构建的内容，请访问valyu.network。 查看我们的博客：valyu.network/blog。