网络搜索MCP服务器

一个基于OpenRouter在线模型的MCP服务器,提供网络搜索功能,支持自定义模型选择和灵活配置。

  • by wdmtech
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 wdmtech/openrouter-search-mcp

使用说明

OpenRouter搜索MCP服务器

一种模型上下文协议(MCP)服务器,使用OpenRouter的在线启用模型提供网络搜索功能。

特性

  • 网页搜索:使用OpenRouter的在线模型搜索网络
  • 可定制的模型:通过环境变量或每个请求参数配置要使用的OpenRouter模型
  • 灵活的配置:支持全局和按请求选择模型

安装

  1. 在MCP服务器目录中克隆或创建此服务器
  2. 安装依赖项:
    npm install
    
  3. 构建服务器:
    npm run build
    

配置

环境变量

  • OPENROUTER_API_KEY (必需):您的OpenRouter API密钥
  • DEFAULT_MODEL (可选):要使用的默认模型(默认为 openai/gpt-4o:online)

MCP设置

添加到MCP设置配置中:

{
  "mcpServers": {
    "openrouter-search": {
      "command": "node",
      "args": ["/path/to/openrouter-search/build/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here",
        "DEFAULT_MODEL": "openai/gpt-4o:online"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

web_search

使用OpenRouter的在线模型搜索网络。

参数:

  • query (字符串,必填):搜索查询
  • model (字符串,可选):用于此搜索的OpenRouter模型

例子:

{
  "query": "latest developments in AI",
  "model": "anthropic/claude-3-5-sonnet:online"
}

支持的型号

对于网络搜索功能,您可以使用任何OpenRouter型号 :online 后缀:

  • openai/gpt-4o:online (默认)
  • anthropic/claude-3-5-sonnet:online
  • anthropic/claude-3-haiku:online
  • google/gemini-pro:online
  • openrouter/auto (使用web插件自动选择最佳模型)

运作原理:添加 :online 任何型号的slug都可以通过Exa支持的OpenRouter网络插件进行网络搜索。这相当于显式使用web插件。

替代:您也可以使用 openrouter/auto 其自动选择最佳模型并启用网络搜索。

使用示例

配置后,您可以通过MCP客户端使用搜索功能:

  1. 基本搜索:“搜索有关量子计算的信息”
  2. 特定型号搜索:使用 web_search 具有特定模型参数的工具
  3. 基于环境:设置 DEFAULT_MODEL 全局更改默认模型

部署

此服务器可以作为web服务部署在Render.com、Heroku或Railway等平台上。

Render.com部署

  1. 将此存储库分叉或克隆到您的GitHub帐户
  2. 将您的GitHub存储库连接到Render.com
  3. 使用以下设置创建新的Web服务:
    • 生成命令: npm install && npm run build
    • 启动命令: npm start
    • 环境变量:
      • OPENROUTER_API_KEY:您的OpenRouter API密钥
      • NODE_ENV: production (可选)
      • DEFAULT_MODEL:您喜欢的型号(可选)

服务器将自动检测部署环境并以web模式运行,同时提供文档界面和RESTneneneba API端点。

Web API终结点

当部署为web服务时:

  • GET / -文档和状态页面
  • GET /health -健康检查端点
  • POST /search -Web搜索端点

API使用示例:

curl -X POST https://your-deployment-url.com/search \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI developments", "model": "openai/gpt-4o:online"}'

发展

要修改或扩展此服务器,请执行以下操作:

  1. 编辑 src/index.ts
  2. 跑 npm run build 编写
  3. 重新启动MCP客户端以重新加载服务器

许可证

MIT许可证