使用说明
OpenRouter映像生成MCP服务器
MCP(模型上下文协议)服务器,通过OpenRouter API提供图像生成功能,支持Gemini 2.5 Flash image Preview等模型。
特性
-
图像生成:使用Google Gemini 2.5 Flash图像预览生成图像
-
灵活的选项:
- 将生成的图像保存到本地文件
安装
- 克隆存储库:
git clone https://github.com/a13.team/openrouter-image-gen-mcp.git
cd openrouter-image-gen-mcp
- 安装依赖项:
npm install
- 构建TypeScript代码:
npm run build
- 设置OpenRouter API密钥:
export OPENROUTER_API_KEY="your-api-key-here"
您可以从获取API密钥 开放路由.
Claude桌面配置
将以下内容添加到您的Claude Desktop配置文件中:
macOS/Linux
地点: ~/.config/claude/claude_desktop_config.json
视窗
地点: %APPDATA%\Claude\claude_desktop_config.json
光标IDE配置
地点: ./cursor/mcp.json
{
"mcpServers": {
"openrouter-image-gen": {
"command": "node",
"args": ["/path/to/openrouter-image-gen-mcp/dist/index.js"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here"
}
}
}
}
替换 /path/to/openrouter-image-gen-mcp 带有安装目录的实际路径。
可用工具
1. generate_image
使用AI模型生成图像。
参数:
prompt(必填):要生成的图像的文本描述model:要使用的模型(默认值:google/gemini-2.5-flash-image-preview)n:要生成的图像数量(1-4,默认值:1)size:图像尺寸(默认值:1024x1024)save_to_file:在本地保存图像(默认值:false)filename:已保存图像的基本文件名show_full_response:在响应中包含完整的base64数据(默认值:false,仅返回简洁的信息)
例子:
{
"prompt": "A serene Japanese garden with cherry blossoms",
"model": "google/gemini-2.5-flash-image-preview",
"save_to_file": true,
"filename": "japanese_garden"
}
注: Gemini图像生成通过聊天完成API工作。该模型将根据您的提示生成一个图像,并在响应中以URL或base64数据的形式返回。Gemini模型不使用尺寸参数。
2. list_models
列出所有可用的图像生成模型。
发展
构建
npm run build
以开发模式运行
npm run dev
启动服务器
npm start
API 文档
故障排除
401身份验证错误
如果您遇到401错误,请检查:
- 您的API密钥已在环境或Claude Desktop配置中正确设置
- API密钥以
sk-or-(OpenRouter格式) - API密钥有效,尚未过期
- 您的OpenRouter帐户中有可用的积分
测试API密钥加载:
node test-api-key.js
常见问题
- API密钥未加载:确保
OPENROUTER_API_KEY在Claude Desktop配置中设置env部分 - 模型访问被拒绝:某些型号需要特定权限或更高级别的帐户
- 无法为Gemini生成图像:Gemini使用聊天完成端点,而不是图像端点
许可证
WTFPL-做他妈的你想做的事公共许可证
贡献
欢迎投稿!请随时提交拉取请求。
其他型号:
`google/gemini-3-pro-image-preview`
`google/gemini-2.5-flash-image`
`google/gemini-2.5-flash-image-preview`