
OpenRouter Search MCP Server

2025.04.07
5
TypeScript网页搜索AI 模型集成搜索工具
OpenRouter Search MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,旨在通过 OpenRouter API 提供网页搜索功能。该服务器集成了特定的 AI 模型(google/gemini-2.5-pro-exp-03-25:free:online),并支持直接返回未经处理的原始文本响应。
View on GitHub
Overview
基本能力
产品定位
OpenRouter Search MCP Server 是一个专门用于网页搜索的服务,通过 OpenRouter API 提供高效的搜索功能。
核心功能
- Web Search via OpenRouter: 利用 OpenRouter API 执行网页搜索。
- Specific Model: 使用
google/gemini-2.5-pro-exp-03-25:free:online
模型,:online
后缀启用模型的网页搜索功能。 - Raw Text Output: 返回 AI 模型生成的直接、未解析的文本响应。
- MCP Integration: 提供一个简单的
web_search
工具,与 MCP 客户端兼容。
适用场景
- 需要快速获取网页搜索结果的场景。
- 集成到 MCP 客户端中以增强搜索功能。
工具列表
- web_search: 执行网页搜索,输入为查询字符串,输出为原始文本响应。
常见问题解答
- API Key: 必须设置
OPENROUTER_API_KEY
环境变量,且不要将 API 密钥直接提交到代码或仓库中。 - 路径配置: 确保在 MCP 客户端配置中正确指定
index.js
文件的绝对路径。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
安装教程
- 克隆仓库:
bash git clone https://github.com/joaomj/openrouter-search-server.git cd openrouter-search-server
- 安装依赖:
bash npm install
- 构建:
bash npm run build
调试方式
- 启动服务器:
bash npm start
- 测试工具调用:
使用 MCP 客户端调用
web_search
工具,例如:xml <use_mcp_tool> <server_name>openrouter-search</server_name> <tool_name>web_search</tool_name> <arguments> { "query": "What is the latest version of the MCP SDK?" } </arguments> </use_mcp_tool>