Kimi Vision MCP
一个基于 Kimi K2.5 视觉模型的 MCP 服务器,用于分析图片内容。
功能特性
- ✅ 支持本地图片文件和 URL
- ✅ 支持多种图片格式 (JPG, PNG, GIF, WebP)
- ✅ 安全的 URL 验证,防止 SSRF 攻击
- ✅ 文件大小限制 (最大 10MB)
- ✅ 自定义分析提示词
安装
方式 1: 通过 npm 安装 (推荐)
npm install -g kimi-vision-mcp方式 2: 从源码安装
git clone https://github.com/yourusername/kimi-vision-mcp.git
cd kimi-vision-mcp
npm install
chmod +x index.js配置
1. 获取 Kimi API Key
访问 Moonshot AI 注册并获取 API Key。
2. 配置 Claude Desktop
编辑配置文件:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
使用 npm 全局安装 (推荐)
{
"mcpServers": {
"kimi-vision": {
"command": "kimi-vision-mcp",
"env": {
"KIMI_API_KEY": "your-api-key-here"
}
}
}
}使用本地路径
{
"mcpServers": {
"kimi-vision": {
"command": "node",
"args": ["/absolute/path/to/kimi-vision-mcp/index.js"],
"env": {
"KIMI_API_KEY": "your-api-key-here"
}
}
}
}3. 重启 Claude Desktop
配置完成后,完全退出并重启 Claude Desktop。
使用方法
在 Claude 对话中:
请帮我分析这张图片: /path/to/image.jpg或使用 URL:
请分析这张图片: 自定义提示词
请用以下要求分析图片 /path/to/screenshot.png:
重点关注UI布局和配色方案API 参数
analyze_image
image_path(必需): 图片文件路径或 URLprompt(可选): 对图片的具体问题或要求model(可选): 使用的模型名称,默认kimi-k2.5
支持的图片格式
- JPG/JPEG
- PNG
- GIF
- WebP
限制
- 最大文件大小: 10MB
- 下载超时: 30秒
- 仅支持公开可访问的图片 URL
故障排除
1. "KIMI_API_KEY 环境变量未设置"
确保在配置文件中正确设置了 API Key。
2. "文件不存在"
检查文件路径是否正确,使用绝对路径更可靠。
3. "不支持的 URL 或存在安全风险"
不支持访问本地网络地址 (localhost, 127.0.0.1, 内网 IP 等)。
开发
# 克隆项目
git clone https://github.com/yourusername/kimi-vision-mcp.git
cd kimi-vision-mcp
# 安装依赖
npm install
# 运行
KIMI_API_KEY=your-key node index.js贡献
欢迎提交 Issue 和 Pull Request!
许可证
MIT License