AI导哈

AI模型上下文检索工具

Valyu MCP Server是一款AI模型上下文协议工具，支持从Valyu API检索高质量上下文，包括维基百科、arXiv论文和网络搜索的全面搜索功能。

  • by valyuAI
  • Python
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 valyu-network/valyu-mcp

使用说明

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. 打开克劳德桌面
    2. 转到“设置”
    3. 在“开发人员”选项卡中启用开发人员模式
    4. 配置文件将自动生成

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

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

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

相关 MCP