游标的OpenRouter MCP客户端
Cursor的模型上下文协议（MCP）客户端，利用OpenRouter.ai访问多个ai模型。
需求
- Node.js v18.0.0或更高版本 （重要！）
- OpenRouter API密钥（在 openrouter.ai/keys)
特性
- 通过MCP连接到OpenRouter.ai
- 访问来自不同提供商（谷歌、DeepSeek、Meta等）的多个AI模型
- 使用MCP传输机制与Cursor通信
- 缓存模型信息以减少API调用
- 支持免费和付费型号
- 多模型完成实用程序，用于组合多个模型的结果
可用型号
此客户端提供对OpenRouter上所有可用型号的访问，包括：
- 谷歌双子座2.5 Pro
- DeepSeek聊天v3
- Meta Calma 3.1
- DeepSeek R1
- Qwen编码器
- 米斯特拉尔小3.1
- 还有更多！
快速安装
最简单的安装方法是使用安装脚本：
# Clone the repository
git clone https://your-repo-url/openrouter-mcp-client.git
cd openrouter-mcp-client
# Run the installation script
node install.cjs脚本将：
- 帮助您创建
.env使用OpenRouter API密钥的文件 - 安装所有依赖项
- 构建项目
- 提供后续步骤
手动安装
如果您更喜欢手动安装：
# Clone the repository
git clone https://your-repo-url/openrouter-mcp-client.git
cd openrouter-mcp-client
# Install dependencies
npm install
# Copy environment file and edit it with your API key
cp .env.example .env
# Edit .env file with your OpenRouter API key
# Build the project
npm run build配置
编辑 .env 使用OpenRouter API密钥和默认模型的文件：
OPENROUTER_API_KEY=your_api_key_here
OPENROUTER_DEFAULT_MODEL=google/gemini-2.5-pro-exp-03-25:free从获取API密钥 OpenRouter密钥.
光标集成
要将此客户端与Cursor一起使用，您需要更新Cursor的MCP配置文件：
- 查找Cursor的配置目录：
- 窗户： %USERPROFILE%\.cursor\ - macOS： ~/.cursor/ - Linux： ~/.cursor/
- 编辑或创建
mcp.json该目录中的文件。添加这样的配置：
{
"mcpServers": {
"custom-openrouter-client": {
"command": "node",
"args": [
"FULL_PATH_TO/openrouter-mcp-client/dist/index.js"
],
"env": {
"OPENROUTER_API_KEY": "your_api_key_here",
"OPENROUTER_DEFAULT_MODEL": "google/gemini-2.5-pro-exp-03-25:free"
}
}
}
}替换 FULL_PATH_TO 使用客户端安装的实际路径。
- 重新启动游标
- 通过以下方式选择客户端：
- 打开光标 - 按Ctrl+Shift+L（Windows/Linux）或Cmd+Shift+L（macOS）打开模型选择器 - 从列表中选择“自定义openrouter客户端”
直接测试（无MCP）
取消注释中的测试功能 src/index.ts 测试API的直接交互：
// Uncomment to test the direct API
testDirectApi().catch(console.error);
testMultiModelCompletion().catch(console.error);然后运行：
npm start发展
# Watch mode for development
npm run dev故障排除
Node.js版本要求
重要提示： 此项目需要Node.js v18.0.0或更高版本。如果您使用的是旧版本，您将看到EBADENGINE警告，并可能遇到错误。检查你的Node.js版本：
node --version如果您有旧版本，请从以下网址下载并安装最新的LTS版本 .
模块系统错误
如果你遇到与ES模块和CommonJS相关的错误：
- 主代码库使用ES模块（由
"type": "module"在package.json中） - 安装脚本使用CommonJS（扩展名为.cjs）
- 确保使用以下命令运行安装脚本
node install.cjs
光标未连接
如果Cursor似乎无法连接到您的客户端：
- 确保路径正确
mcp.json正确并使用正斜杠 - 检查您是否已使用构建客户端
npm run build - 验证您的OpenRouter API密钥在env设置中是否正确
- 检查游标日志是否有任何错误
相关资源
Smithery部署
您可以将此MCP客户端部署到 史密瑟里 使其可用于各种AI代理和应用程序。
先决条件
- GitHub账号
- OpenRouter API密钥
部署步骤
- 分叉此存储库 转到您的GitHub帐户
- 登录Smithery 在 史密斯艾 使用您的GitHub帐户
- 添加新服务器:
- 单击Smithery仪表板中的“添加服务器” - 选择您的分叉存储库 - 配置生成设置： - 将基本目录设置为存储库根目录 - 确保检测到Dockerfile和smithery.yaml
- 部署您的服务器:
- Smithery将自动构建和部署您的MCP服务器 - 一旦部署，用户可以使用自己的OpenRouter API密钥对其进行配置
使用已部署的服务器
部署后，用户可以通过Smithery注册表访问您的服务器：
- 在他们的MCP客户端（如Claude或任何其他MCP兼容客户端）中，使用Smithery的注册表添加服务器
- 配置其OpenRouter API密钥和首选默认模型
- 开始使用服务器通过OpenRouter访问多个AI模型
Smithery与本地安装
- 史密瑟里更容易分发给他人；用户无需克隆和构建存储库
- 本地安装更适合个人使用和发展；加强对环境的控制
选择最适合您需求的方法。