Valyu MCP Server

Valyu MCP服务器

Valyu MCP服务器是一种模型上下文协议（MCP）工具，使人工智能模型能够从Valyu的API中检索高质量的上下文，包括维基百科、arXiv论文（非常适合金融、研究等）和网络搜索的完整搜索功能。

先决条件

在设置MCP服务器之前，请确保您拥有以下内容：

1. Python 3.10+
2. 克劳德桌面（最新版本）
3. Valyu API密钥 （从以下地址获取一个 Valyu交易所)

要检查您的Python版本，请运行：

python --version

安装和配置

选项1：自动设置（推荐）

1. 克隆存储库

git clone https://github.com/ValyuNetwork/valyu-mcp.git
cd valyu-mcp

1. 运行安装脚本

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

1. 创建虚拟环境并激活它

python -m venv .venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate    # Windows

1. 安装依赖项

pip install -r requirements.txt

1. 创建一个 .env 项目根目录中的文件：

echo "VALYU_API_KEY=your-api-key-here" > .env

1. 打开Claude Desktop配置文件进行编辑：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json

如果配置文件不存在：

1. 打开克劳德桌面 1. 转到“设置” 1. 在“开发人员”选项卡中启用开发人员模式 1. 配置文件将自动生成

您可以使用以下命令在VS Code中打开此文件：

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json  # macOS
   code %APPDATA%\Claude\claude_desktop_config.json  # Windows (PowerShell)

1. 在下面添加以下条目 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

1. 启动Claude Desktop并验证MCP工具是否被识别：

- 寻找 valyu-mcp Claude界面中的工具。 - 在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交易所 并要求您 $10免费积分 用MCP服务器测试Valyu API。

贡献

欢迎拉取请求！对于bug报告或功能请求，请随时打开问题。

许可证

该项目根据MIT许可证获得许可。

______________________________________________________________________

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