Valyu MCP 服务器

Valyu MCP 服务器是一个模型上下文协议 (MCP) 工具，它使 AI 模型能够从 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": ["-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 免费额度，以使用 MCP 服务器测试 Valyu API。

贡献

欢迎提交 Pull Request！ 欢迎提出 bug 报告或功能请求。

许可证

本项目采用 MIT 许可证。

---

有关我们在 Valyu 构建的更多信息，请访问 valyu.network。 并查看我们的博客 valyu.network/blog。