Dino X MCP

🚀 DINO-X MCP

DINO-X MCP 藉助 DINO-X 和 Grounding DINO 1.6 API，賦能大語言模型實現細粒度的目標檢測和圖像理解。

🚀 快速開始

1. 前提條件

你可以使用以下方法之一安裝 Node.js：

選項 A：命令行安裝 👍

# 適用於 MacOS 或 Linux
# 1. 安裝 nvm（Node 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 或者
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 2. 將以下行添加到你的配置文件（~/.bash_profile、~/.zshrc、~/.profile 或 ~/.bashrc）
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  

# 3. 在當前 shell 中激活 nvm
source ~/.bashrc
# 或者
source ~/.zshrc   

# 4. 驗證 nvm 安裝
command -v nvm

# 5. 安裝並使用 Node.js 的 LTS 版本
nvm install --lts
nvm use --lts

# 適用於 Windows
winget install OpenJS.NodeJS.LTS
# 或者使用 PowerShell（管理員權限）
iwr -useb https://raw.githubusercontent.com/chocolatey/chocolatey/master/chocolateyInstall/InstallChocolatey.ps1 | iex
choco install nodejs-lts -y

選項 B：手動安裝

從 nodejs.org 下載安裝程序。

此外，選擇一個支持 MCP 客戶端的 AI 助手和應用程序，包括但不限於：

• Cursor
• WindSurf
• Trae
• Cherry Studio

2. 配置 MCP 服務器

你可以通過兩種方式使用 DINO-X MCP 服務器：

選項 A：使用 NPM 包 👍

在你的 MCP 客戶端中添加以下配置：

{
  "mcpServers": {
    "dinox-mcp": {
      "command": "npx",
      "args": ["-y", "@deepdataspace/dinox-mcp"],
      "env": {
        "DINOX_API_KEY": "your-api-key-here",
        "IMAGE_STORAGE_DIRECTORY": "/path/to/your/image/directory"
      }
    }
  }
}

選項 B：使用本地項目

首先，克隆並構建項目：

# 克隆項目
git clone https://github.com/IDEA-Research/DINO-X-MCP.git
cd DINO-X-MCP

# 安裝依賴
pnpm install

# 構建項目
pnpm run build

然後配置你的 MCP 客戶端：

{
  "mcpServers": {
    "dinox-mcp": {
      "command": "node",
      "args": ["/path/to/DINO-X-MCP/build/index.js"],
      "env": {
        "DINOX_API_KEY": "your-api-key-here",
        "IMAGE_STORAGE_DIRECTORY": "/path/to/your/image/directory"
      }
    }
  }
}

3. 獲取 API 密鑰

從 DINO-X 平臺 獲取你的 API 密鑰（新用戶可享受免費配額）。

將上述配置中的 your-api-key-here 替換為你實際的 API 密鑰。

4. 環境變量

DINO-X MCP 服務器支持以下環境變量：

5. 可用工具

重啟你的 MCP 客戶端，你應該能夠使用以下工具：

✨ 主要特性

• 細粒度圖像理解：藉助 DINO-X MCP，能夠實現全場景識別和基於自然語言的目標檢測，達成細粒度的圖像理解。
• 精準信息獲取：可以準確獲取對象的數量、位置和屬性，為視覺問答等任務提供支持。
• 多步工作流構建：能夠與其他 MCP 服務器集成，構建多步視覺工作流。
• 視覺代理搭建：可構建由自然語言驅動的視覺代理，適用於現實世界的自動化場景。

🎬 使用案例

🎯 場景	📝 輸入	✨ 輸出
檢測與定位	💬 提示： 檢測並可視化森林中的火災區域 🖼️ 輸入圖像：
對象計數	💬 提示： 請分析此倉庫圖像，檢測所有紙板箱並統計總數 🖼️ 輸入圖像：
特徵檢測	💬 提示： 在圖像中找到所有紅色汽車 🖼️ 輸入圖像：
屬性推理	💬 提示： 在圖像中找到最高的人，描述他們的穿著 🖼️ 輸入圖像：
全場景檢測	💬 提示： 在圖像中找到維生素 C 含量最高的水果 🖼️ 輸入圖像：	答案：獼猴桃（93mg/100g）
姿態分析	💬 提示： 請分析這是什麼瑜伽姿勢 🖼️ 輸入圖像：

📝 使用說明

支持的圖像格式

• 以 https:// 開頭的遠程 URL 👍
• 本地文件路徑（以 file:// 開頭）
• 常見圖像格式：jpg, jpeg, png, webp

API 文檔

請參考 DINO-X 平臺 獲取 API 使用限制和定價信息。

🛠️ 開發

監聽模式

在開發過程中，你可以使用監聽模式進行自動重建：

pnpm run watch

調試

使用 MCP 檢查器調試服務器：

pnpm run inspector

📄 許可證

本項目採用 Apache License 2.0 許可證。