DINO-X

Máy chủ MCP DINO-X

English | 中文

Máy chủ MCP Chính thức của DINO-X — được hỗ trợ bởi các mô hình DINO-X và Grounding DINO — mang đến khả năng phát hiện đối tượng chi tiết và hiểu hình ảnh cho các ứng dụng đa phương thức của bạn.

Trình duyệt của bạn không hỗ trợ thẻ video.

Tại sao nên dùng DINO-X MCP?

Với DINO-X MCP, bạn có thể:

• Hiểu biết chi tiết: Phát hiện toàn bộ hình ảnh, phát hiện đối tượng và mô tả cấp vùng.

• Đầu ra có cấu trúc: Nhận danh mục đối tượng, số lượng, vị trí và thuộc tính cho các tác vụ VQA và suy luận đa bước.

• Có thể kết hợp: Hoạt động liền mạch với các máy chủ MCP khác để xây dựng các tác nhân thị giác đầu cuối hoặc quy trình tự động hóa.

Chế độ Truyền tải

DINO-X MCP hỗ trợ hai chế độ truyền tải:

Tính năng	STDIO (mặc định)	HTTP có thể truyền phát
Thời gian chạy	Cục bộ	Cục bộ hoặc Đám mây
Truyền tải	I/O Tiêu chuẩn	HTTP (phản hồi truyền phát)
Nguồn đầu vào	file:// và https://	Chỉ https://
Trực quan hóa	Được hỗ trợ (lưu ảnh đã chú thích cục bộ)	Chưa được hỗ trợ (hiện tại)

Bắt đầu Nhanh

1. Chuẩn bị một máy khách MCP

Bất kỳ máy khách tương thích MCP nào cũng hoạt động, ví dụ:

• Cursor
• WindSurf
• Trae
• Cherry Studio

2. Lấy khóa API của bạn

Đăng ký trên nền tảng DINO-X: Yêu cầu Khóa API (người dùng mới nhận được hạn ngạch miễn phí).

3. Cấu hình MCP

Tùy chọn A: HTTP có thể truyền phát được Lưu trữ Chính thức (Khuyến nghị)

Thêm vào cấu hình máy khách MCP của bạn và thay thế bằng khóa API của bạn:

{
  "mcpServers": {
    "dinox-mcp": {
      "url": "https://mcp.deepdataspace.com/mcp?key=your-api-key"
    }
  }
}

Tùy chọn B: Sử dụng gói NPM cục bộ (STDIO)

Cài đặt Node.js trước

• Tải trình cài đặt từ nodejs.org

• Hoặc sử dụng lệnh:

# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# or
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# load nvm into current shell (choose the one you use)
source ~/.bashrc || true
source ~/.zshrc  || true

# install and use LTS Node.js
nvm install --lts
nvm use --lts

# Windows (one of the following)
winget install OpenJS.NodeJS.LTS
# or with Chocolatey (in admin PowerShell)
iwr -useb https://raw.githubusercontent.com/chocolatey/chocolatey/master/chocolateyInstall/InstallChocolatey.ps1 | iex
choco install nodejs-lts -y

Cấu hình máy khách MCP của bạn:

{
  "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"
      }
    }
  }
}

Lưu ý: Thay thế your-api-key-here bằng khóa thực của bạn.

Tùy chọn C: Chạy từ mã nguồn cục bộ

Đảm bảo Node.js đã được cài đặt (xem Tùy chọn B), sau đó:

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

# install deps
npm install

# build
npm run build

Cấu hình máy khách MCP của bạn:

{
  "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"
      }
    }
  }
}

Cờ CLI & Biến Môi trường

• Cờ chung

  • --http: khởi động ở chế độ HTTP có thể truyền phát (nếu không thì mặc định là STDIO)
  • --stdio: buộc chế độ STDIO
  • --dinox-api-key=...: đặt khóa API
  • --enable-client-key: cho phép khóa API qua URL ?key= (chỉ HTTP có thể truyền phát)
  • --port=8080: cổng HTTP (mặc định 3020)

• Biến môi trường

  • DINOX_API_KEY (bắt buộc/bắt buộc có điều kiện): Khóa API nền tảng DINO-X
  • IMAGE_STORAGE_DIRECTORY (tùy chọn, STDIO): thư mục để lưu ảnh đã chú thích
  • AUTH_TOKEN (tùy chọn, HTTP): nếu được đặt, máy khách phải gửi Authorization: Bearer <token>

  Ví dụ:

# STDIO (local)
node build/index.js --dinox-api-key=your-api-key

# Streamable HTTP (server provides a shared API key)
node build/index.js --http --dinox-api-key=your-api-key

# Streamable HTTP (custom port)
node build/index.js --http --dinox-api-key=your-api-key --port=8080

# Streamable HTTP (require client-provided API key via URL)
node build/index.js --http --enable-client-key

Cấu hình máy khách khi sử dụng ?key=:

{
  "mcpServers": {
    "dinox-mcp": {
      "url": "http://localhost:3020/mcp?key=your-api-key"
    }
  }
}

Sử dụng AUTH_TOKEN với một cổng tiêm vào Authorization: Bearer <token>:

AUTH_TOKEN=my-token node build/index.js --http --enable-client-key

Ví dụ máy khách với supergateway:

{
  "mcpServers": {
    "dinox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "http://localhost:3020/mcp?key=your-api-key",
        "--oauth2Bearer",
        "my-token"
      ]
    }
  }
}

Công cụ

Khả năng	ID Công cụ	Truyền tải	Đầu vào	Đầu ra
Phát hiện đối tượng toàn cảnh	detect-all-objects	STDIO / HTTP	URL Hình ảnh	Danh mục + bbox + (tùy chọn) chú thích
Phát hiện đối tượng theo lời nhắc văn bản	detect-objects-by-text	STDIO / HTTP	URL Hình ảnh + Danh từ tiếng Anh (phân cách bằng dấu chấm cho nhiều đối tượng, ví dụ: person.car)	bbox đối tượng mục tiêu + (tùy chọn) chú thích
Ước lượng tư thế người	detect-human-pose-keypoints	STDIO / HTTP	URL Hình ảnh	17 điểm chính + bbox + (tùy chọn) chú thích
Trực quan hóa	visualize-detection-result	Chỉ STDIO	URL Hình ảnh + mảng kết quả phát hiện	Đường dẫn cục bộ đến ảnh đã chú thích

🎬 Các Trường hợp Sử dụng

🎯 Kịch bản	📝 Đầu vào	✨ Đầu ra
Phát hiện & Định vị	💬 Lời nhắc: Detect and visualize the fire areas in the forest 🖼️ Ảnh Đầu vào:
Đếm Đối tượng	💬 Lời nhắc: Please analyze this warehouse image, detect all the cardboard boxes, count the total number 🖼️ Ảnh Đầu vào:
Phát hiện Đặc điểm	💬 Lời nhắc: Find all red cars in the image 🖼️ Ảnh Đầu vào:
Suy luận Thuộc tính	💬 Lời nhắc: Find the tallest person in the image, describe their clothing 🖼️ Ảnh Đầu vào:
Phát hiện Toàn cảnh	💬 Lời nhắc: Find the fruit with the highest vitamin C content in the image 🖼️ Ảnh Đầu vào:	Trả lời: Quả Kiwi (93mg/100g)
Phân tích Tư thế	💬 Lời nhắc: Please analyze what yoga pose this is 🖼️ Ảnh Đầu vào:

Câu hỏi Thường gặp

• Nguồn ảnh được hỗ trợ?
  • STDIO: file:// và https://
  • HTTP có thể truyền phát: chỉ https://
• Định dạng ảnh được hỗ trợ?
  • jpg, jpeg, webp, png

Phát triển & Gỡ lỗi

Sử dụng chế độ theo dõi để tự động xây dựng lại trong quá trình phát triển:

npm run watch

Sử dụng MCP Inspector để gỡ lỗi:

npm run inspector

Giấy phép

Giấy phép Apache 2.0