← Retour aux intégrations

JADE REALMS / Documentation développeur

Connexion MCP

Ajoutez cette URL dans un client compatible Streamable HTTP distant, choisissez sans authentification puis découvrez les outils. Le navigateur peut être fermé.

v1.0.0Lecture seule · sans clé APIOpenAPI JSON ↗

Étapes de connexion

Ajoutez cette URL dans un client compatible Streamable HTTP distant, choisissez sans authentification puis découvrez les outils. Le navigateur peut être fermé.

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

Distinct du WebMCP du navigateur. OAuth, bibliothèques achetées et commandes privées ne sont pas inclus.

Outils MCP

Outils MCPREST APIObligatoire
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

Rechercher → consulter → télécharger

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

Exemple de client

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": "fr"
    }
  });
  console.log(result.structuredContent);
} finally {
  await client.close();
}

Exemples de protocole

GET dans la barre d’adresse renvoie 405. Le serveur attend des messages MCP POST ; utilisez ces exemples ou le SDK officiel.

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

Portée et compatibilité

Renvoie métadonnées et URL. Aucun achat, accès privé ou écriture dans un projet local. La 3D dans le chat dépend du client.

Uniquement des faits publiés. Les inconnues restent null ; les vérifications portent sur le hash GLB et ne certifient pas les performances.

Les métadonnées partagent une limite au mieux de 120 requêtes par minute et IP dans chaque site Cloudflare. Ce n’est pas un quota de fichiers gratuits.

  • 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

Erreurs et reprises

HTTP / JSON-RPCDescription
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.

Ajouter à une collection

Nouvelle collection