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：手动安装

如果 preferring 手动设置或自动化安装在您的环境中不可用，请按照以下步骤操作：

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 网站 或联系支持团队。