🌙 Moondream MCP Server

一款强大的模型上下文协议（MCP）服务器，它利用Moondream视觉模型为您的应用程序带来先进的图像分析能力。此服务器无缝集成到Claude和Cline中，提供AI助手与复杂计算机视觉任务之间的桥梁。

这不是官方的Moondream包。感谢moondream.ai提供的最佳开源视觉模型，您可以在消费级硬件上运行该模型。

<div align="center" style="height: 150px; overflow: hidden; display: flex; align-items: center; margin: 20px 0;"> <img src="https://gips0.baidu.com/it/u=671964350,4288944934&fm=3081&app=3_081&f=JPEG?w=1792&h=1024" alt="Moondream MCP Banner" style="width: 100%; object-fit: cover;"> </div>

✨ 特性

• 🖼️ 图像字幕生成：为图像生成自然语言描述
• 🔍 目标检测：识别并定位图像中的特定对象
• 💭 视觉问答：就图像内容提问并获得智能回答
• 🚀 高性能：使用量化8位模型进行高效推理
• 🔄 自动设置：处理模型下载和环境设置
• 🛠️ MCP集成：标准化协议以实现工具的无缝使用

🎯 使用场景

• 内容分析：自动生成图像内容的描述
• 无障碍访问：为视障用户提供替代文本
• 数据提取：通过有针对性的问题从图像中提取特定信息
• 目标验证：确认图像中特定对象的存在
• 场景理解：分析复杂的场景及其组成部分

🚀 快速开始

先决条件

• Node.js v18或更高版本
• Python 3.8+
• UV包管理器（如果未安装则会自动安装）

安装

1. 克隆并设置

git clone <repository-url>
cd moondream-server
pnpm install

2. 构建服务器

pnpm run build

服务器会自动处理以下操作：

• 创建Python虚拟环境
• 如果未安装，则安装UV
• 下载并设置Moondream模型
• 管理模型服务器进程

与Claude/Cline集成

在您的MCP设置文件（claude_desktop_config.json 或 cline_mcp_settings.json）中添加：

{
  "mcpServers": {
    "moondream": {
      "command": "node",
      "args": ["/path/to/moondream-server/build/index.js"]
    }
  }
}

🛠️ 可用工具

analyze_image

强大的图像分析工具，具有多种模式：

{
  "name": "analyze_image",
  "arguments": {
    "image_path": string,  // 图像文件路径
    "prompt": string       // 分析指令
  }
}

指令类型：

• "generate caption" - 创建自然语言描述
• "detect: [object]" - 查找特定对象（例如，“detect: car”）
• "[question]" - 回答关于图像的问题

示例：

// 图像字幕生成
{
  "image_path": "photo.jpg",
  "prompt": "generate caption"
}

// 目标检测
{
  "image_path": "scene.jpg",
  "prompt": "detect: person"
}

// 视觉问答
{
  "image_path": "painting.jpg",
  "prompt": "这幅画中使用了哪些颜色？"
}

🔧 技术细节

架构

服务器作为一个双组件系统运行：

1. MCP接口层

   • 处理协议通信
   • 管理工具接口
   • 处理请求/响应

2. Moondream模型服务器

   • 运行视觉模型
   • 处理图像分析
   • 提供HTTP API端点

模型信息

使用Moondream量化模型：

• 默认：moondream-2b-int8.mf.gz
• 高效8位量化
• 自动从Hugging Face下载
• 模型大小约500MB

性能

• 快速启动并自动缓存
• 通过量化实现高效的内存使用
• 响应式API端点
• 并发请求处理

🔍 调试

常见问题及解决方案：

1. 模型下载问题

   # 手动下载模型
   wget https://huggingface.co/vikhyatk/moondream2/resolve/main/moondream-0_5b-int4.mf.gz
   

2. 服务器端口冲突

   • 默认端口：3475
   • 检查占用该端口的进程：lsof -i :3475

3. Python环境

   • UV管理依赖项
   • 检查临时目录中的日志
   • 虚拟环境位于系统临时文件夹中

🤝 贡献

欢迎贡献！感兴趣的领域包括：

• 支持更多模型
• 性能优化
• 新的分析能力
• 文档改进

📄 许可证

[在此处添加您的许可证信息]

🙏 致谢

• Moondream模型团队
• 模型上下文协议（MCP）社区
• 贡献者和维护者

---

<p align="center"> 由Nighttrek制作 ❤️ </p>