Valyu MCP Server

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. 前往 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 注册并领取 $10 免费额度，即可通过 MCP 服务测试 Valyu API。

贡献

欢迎提交拉取请求！如需报告 Bug 或提出功能请求，也欢迎提交 Issue。

许可证

本项目采用 MIT 许可证。

---

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