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