← Zurück zu Integrationen

JADE REALMS / Entwicklerdokumentation

Mit MCP verbinden

In einem Client mit entferntem Streamable HTTP die URL hinzufügen, keine Authentifizierung wählen und Tools abrufen. Kein dauerhaft offener Browser nötig.

v1.0.0Nur Lesen · kein API-SchlüsselOpenAPI JSON ↗

Verbindungsschritte

In einem Client mit entferntem Streamable HTTP die URL hinzufügen, keine Authentifizierung wählen und Tools abrufen. Kein dauerhaft offener Browser nötig.

URL
https://3dmodelhub.io/mcp
  1. Add a remote MCP server using this URL and Streamable HTTP transport.
  2. Select None for authentication. This public service has no API key or OAuth sign-in step.
  3. Discover the seven tools below. Read site information, search models, then request download URLs.
Transport
Streamable HTTP
Authentication
None
Server
jaderealms-public-assets

Unabhängig vom Browser-WebMCP. OAuth, gekaufte Bibliotheken und private Bestellungen sind nicht enthalten.

MCP-Tools

MCP-ToolsREST APIErforderlich
jaderealms_get_site_infoGET /api/v1/site—
jaderealms_search_modelsGET /api/v1/models—
jaderealms_get_model_detailsGET /api/v1/models/{id}id
jaderealms_list_scene_kitsGET /api/v1/kits—
jaderealms_get_scene_kit_detailsGET /api/v1/kits/{id}id
jaderealms_get_usage_guidanceGET /api/v1/guidancetopic
jaderealms_get_model_downloadsGET /api/v1/models/{id}/downloadsid

Suchen → prüfen → herunterladen

Tool arguments
{
  "name": "jaderealms_search_models",
  "arguments": {
    "q": "pine",
    "tested_engine": "godot",
    "max_triangles": 150000,
    "limit": 3,
    "locale": "de"
  }
}

Client-Beispiel

Setup
npm install --save-exact @modelcontextprotocol/sdk@1.32.1
JavaScript · Node.js 22+
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'asset-library-client', version: '1.0.0' });
try {
  await client.connect(new StreamableHTTPClientTransport(new URL("https://3dmodelhub.io/mcp")));
  console.log(await client.listTools());
  const result = await client.callTool({
    "name": "jaderealms_search_models",
    "arguments": {
      "q": "pine",
      "tested_engine": "godot",
      "max_triangles": 150000,
      "limit": 3,
      "locale": "de"
    }
  });
  console.log(result.structuredContent);
} finally {
  await client.close();
}

Protokollbeispiele

GET in der Adressleiste ergibt 405. Der Server erwartet MCP-POST-Nachrichten; nutze diese Beispiele oder das offizielle SDK.

1 · initialize
curl --fail 'https://3dmodelhub.io/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"manual-check","version":"1.0.0"}}}'

Umfang und Kompatibilität

Gibt Metadaten und URLs zurück. Kauft nichts, liest keine privaten Konten und schreibt keine lokalen Projekte. 3D im Chat hängt vom Client ab.

Nur veröffentlichte Fakten. Unbekanntes bleibt null; Prüfungen gelten für den GLB-Hash und bestätigen keine Leistung.

Metadaten teilen je Cloudflare-Standort ein Best-Effort-Limit von 120 Anfragen pro Minute und IP. Dies ist kein Downloadkontingent für kostenlose Dateien.

  • POST: initialize / notifications / tools/list / tools/call
  • GET / DELETE: 405 · OPTIONS: 204
  • JSON response · no persistent session ID · 32 KiB message limit
  • tools/call: content + structuredContent; isError=true on invalid arguments

Fehler und Wiederholung

HTTP / JSON-RPCBeschreibung
405GET from an address bar is unsupported; connect with MCP POST.
406Accept must include both application/json and text/event-stream.
415Send JSON with Content-Type: application/json.
403Browser Origin is not allowed. Default origins cover this site and configured ChatGPT, Claude and Cursor origins. A site administrator can configure MCP_ALLOWED_ORIGINS for another browser client.
413Messages must fit within 32 KiB; batch messages are unsupported.
429Wait for Retry-After before retrying.
JSON-RPC / tools/callCheck JSON-RPC error first. If result.isError is true, inspect structuredContent or text for the tool error instead of treating it as success.

Zu einer Sammlung hinzufügen

Neue Sammlung