DINO-X

resmi

Server MCP visi komputer dan deteksi objek canggih yang didukung oleh Dino-X, memungkinkan agen AI menganalisis gambar, mendeteksi objek, mengidentifikasi titik kunci, dan melakukan tugas pemahaman visual.

GitHub

110

Apa yang bisa Anda lakukan dengan DINO X MCP?

Deteksi semua objek dalam suatu adegan — Minta asisten untuk mengidentifikasi setiap objek dalam gambar beserta kategori dan kotak pembatas menggunakan detect-all-objects.
Temukan objek berdasarkan petunjuk teks — Minta deteksi item tertentu (misalnya, “person.car”) dalam gambar melalui detect-objects-by-text.
Perkirakan titik kunci pose manusia — Dapatkan 17 titik kunci tubuh dan kotak pembatas untuk orang dalam gambar dengan detect-human-pose-keypoints.
Hasilkan visualisasi beranotasi — Hasilkan gambar dengan hasil deteksi yang digambar di atasnya menggunakan visualize-detection-result (hanya mode STDIO).

Dokumentasi

Server MCP DINO-X

English | 中文

Server MCP Resmi DINO-X — didukung oleh model DINO-X dan Grounding DINO — menghadirkan deteksi objek terperinci dan pemahaman gambar ke aplikasi multimodal Anda.

Peramban Anda tidak mendukung tag video.

Mengapa DINO-X MCP?

Dengan DINO-X MCP, Anda dapat:

Pemahaman Terperinci: Deteksi gambar penuh, deteksi objek, dan deskripsi tingkat wilayah.
Keluaran Terstruktur: Dapatkan kategori objek, jumlah, lokasi, dan atribut untuk VQA dan tugas penalaran multi-langkah.
Dapat Disusun: Bekerja mulus dengan server MCP lain untuk membangun agen visual ujung-ke-ujung atau jalur otomatisasi.

Mode Transport

DINO-X MCP mendukung dua mode transport:

Fitur	STDIO (default)	HTTP Streamable
Runtime	Lokal	Lokal atau Cloud
Transport	I/O Standar	HTTP (respons streaming)
Sumber input	`file://` dan `https://`	`https://` saja
Visualisasi	Didukung (menyimpan gambar beranotasi secara lokal)	Tidak didukung (untuk saat ini)

Mulai Cepat

1. Siapkan klien MCP

Klien apa pun yang kompatibel dengan MCP dapat digunakan, misalnya:

2. Dapatkan kunci API Anda

Ajukan di platform DINO-X: Minta Kunci API (pengguna baru mendapatkan kuota gratis).

3. Konfigurasi MCP

Opsi A: HTTP Streamable Hosting Resmi (Direkomendasikan)

Tambahkan ke konfigurasi klien MCP Anda dan ganti dengan kunci API Anda:

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

Opsi B: Gunakan paket NPM secara lokal (STDIO)

Instal Node.js terlebih dahulu

Unduh penginstal dari nodejs.org
Atau gunakan perintah:

# 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

Konfigurasikan klien MCP Anda:

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

Catatan: Ganti your-api-key-here dengan kunci asli Anda.

Opsi C: Jalankan dari sumber secara lokal

Pastikan Node.js terinstal (lihat Opsi B), lalu:

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

# install deps
npm install

# build
npm run build

Konfigurasikan klien MCP Anda:

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

Bendera CLI & Variabel Lingkungan

Bendera umum
- --http: mulai dalam mode HTTP Streamable (jika tidak, STDIO secara default)
- --stdio: paksa mode STDIO
- --dinox-api-key=...: atur kunci API
- --enable-client-key: izinkan kunci API melalui URL ?key= (hanya HTTP Streamable)
- --port=8080: port HTTP (default 3020)
Variabel lingkungan
- DINOX_API_KEY (wajib/diperlukan bersyarat): kunci API platform DINO-X
- IMAGE_STORAGE_DIRECTORY (opsional, STDIO): direktori untuk menyimpan gambar beranotasi
- AUTH_TOKEN (opsional, HTTP): jika diatur, klien harus mengirim Authorization: Bearer <token>
Contoh:

# 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

Konfigurasi klien saat menggunakan ?key=:

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

Menggunakan AUTH_TOKEN dengan gateway yang menyuntikkan Authorization: Bearer <token>:

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

Contoh klien dengan supergateway:

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

Alat

Kemampuan	ID Alat	Transport	Input	Output
Deteksi objek seluruh adegan	`detect-all-objects`	STDIO / HTTP	URL Gambar	Kategori + bbox + (opsional) keterangan
Deteksi objek dengan perintah teks	`detect-objects-by-text`	STDIO / HTTP	URL Gambar + kata benda Bahasa Inggris (dipisahkan titik untuk banyak, mis., `person.car`)	bbox objek target + (opsional) keterangan
Estimasi pose manusia	`detect-human-pose-keypoints`	STDIO / HTTP	URL Gambar	17 titik kunci + bbox + (opsional) keterangan
Visualisasi	`visualize-detection-result`	STDIO saja	URL Gambar + array hasil deteksi	Jalur lokal ke gambar beranotasi

🎬 Kasus Penggunaan

🎯 Skenario	📝 Input	✨ Output
Deteksi & Lokalisasi	💬 Prompt: `Detect and visualize the` `fire areas in the forest` 🖼️ Gambar Input:
Penghitungan Objek	💬 Prompt: `Please analyze this` `warehouse image, detect` `all the cardboard boxes,` `count the total number` 🖼️ Gambar Input:
Deteksi Fitur	💬 Prompt: `Find all red cars` `in the image` 🖼️ Gambar Input:
Penalaran Atribut	💬 Prompt: `Find the tallest person` `in the image, describe` `their clothing` 🖼️ Gambar Input:
Deteksi Seluruh Adegan	💬 Prompt: `Find the fruit with` `the highest vitamin C` `content in the image` 🖼️ Gambar Input:	Jawaban: Buah Kiwi (93mg/100g)
Analisis Pose	💬 Prompt: `Please analyze what` `yoga pose this is` 🖼️ Gambar Input: