Moondream

🚀 🌙 月亮夢 MCP 服務器

月亮夢 MCP 服務器是一款功能強大的模型上下文協議（MCP）服務器，藉助月亮夢視覺模型，能為應用程序賦予先進的圖像分析能力。該服務器可與 Claude 和 Cline 實現無縫集成，成為 AI 助手與複雜計算機視覺任務之間的重要橋樑。

需要注意的是，這並非官方的月亮夢包。所有榮譽歸於 moondream.ai，感謝他們開發出了可在消費級硬件上運行的優秀開源視覺模型。

🚀 快速開始

先決條件

• Node.js v18 或更高版本
• Python 3.8+
• UV 包管理器（若未安裝，會自動進行安裝）

安裝

1. 克隆和設置

git clone <repository-url>
npm install

2. 啟動服務器

node index.js

✨ 主要特性

• 🖼️ 圖像描述生成：能夠為圖像生成自然語言描述。
• 🔍 目標檢測：可識別並定位圖像中的特定對象。
• 💭 視覺問答：能對圖像內容提出問題並獲得智能回答。
• 🚀 高性能：通過使用量化 8 位模型實現高效推理。
• 🔄 自動設置：可自動處理模型下載和環境配置。
• 🛠️ MCP 集成：藉助標準化協議實現工具的無縫使用。

🎯 使用場景

• 內容分析：自動生成圖像內容描述。
• 可訪問性：為視障用戶提供替代文本。
• 數據提取：通過定向問題從圖像中提取信息。
• 目標驗證：確認圖像中特定對象的存在。
• 場景理解：分析複雜場景及其組成部分。

📦 安裝指南

在項目根目錄中創建 config.json 文件，並添加以下內容：

{
  "port": 3475,
  "modelPath": "./models",
  "logLevel": "info"
}

🔧 技術細節

• 服務器端口：默認端口為 3475。
• 支持的模型：兼容 moonsream 模型格式。
• 日誌記錄：使用 Winston 實現日誌記錄，默認輸出到控制檯。

⚠️ 注意事項

⚠️ 重要提示

1. 在生產環境中，請確保服務器運行在 HTTPS 上。
2. 定期更新月亮夢模型以獲得最佳性能。
3. 確保 Python 依賴項已正確安裝。

🤝 貢獻指南

歡迎大家參與貢獻！可參與的領域如下：

• 添加新的視覺模型支持。
• 提升服務器性能。
• 實現新的分析功能。
• 改進文檔。

請提交拉取請求到 main 分支，並確保代碼符合項目規範。

📄 許可證

[在此處添加許可證信息]

🙏 致謝

感謝以下貢獻者和維護者：

• 月亮夢模型團隊
• 模型上下文協議（MCP）社區
• 所有貢獻者

由 Nighttrek 製作 ❤️