JADE REALMS / 開発者向けドキュメント

MCP 接続ガイド

リモート Streamable HTTP 対応クライアントで下記 URL を追加し、認証なしを選んでツールを取得します。ブラウザーを開いたままにする必要はありません。

v1.0.0読み取り専用 · API キー不要OpenAPI JSON ↗

接続手順

URL

https://3dmodelhub.io/mcp

Add a remote MCP server using this URL and Streamable HTTP transport.
Select None for authentication. This public service has no API key or OAuth sign-in step.
Discover the seven tools below. Read site information, search models, then request download URLs.

Transport: Streamable HTTP
Authentication: None
Server: jaderealms-public-assets

ブラウザー WebMCP とは別の標準リモート接続です。OAuth、購入済みライブラリ、非公開注文は本リリースに含まれません。

MCP ツール

MCP ツール	REST API	必須
`jaderealms_get_site_info`	`GET /api/v1/site`	—
`jaderealms_search_models`	`GET /api/v1/models`	—
`jaderealms_get_model_details`	`GET /api/v1/models/{id}`	id
`jaderealms_list_scene_kits`	`GET /api/v1/kits`	—
`jaderealms_get_scene_kit_details`	`GET /api/v1/kits/{id}`	id
`jaderealms_get_usage_guidance`	`GET /api/v1/guidance`	topic
`jaderealms_get_model_downloads`	`GET /api/v1/models/{id}/downloads`	id

検索 → 詳細 → ダウンロード

Tool arguments

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

クライアントの例

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

プロトコル例

アドレスバーからの GET は 405 です。MCP POST メッセージを受け付けるため、下記例または公式 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"}}}'

2 · initialized

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","method":"notifications/initialized"}'

3 · tools/list

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":2,"method":"tools/list","params":{}}'

4 · tools/call

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":3,"method":"tools/call","params":{"name":"jaderealms_search_models","arguments":{"q":"pine","tested_engine":"godot","max_triangles":150000,"limit":3,"locale":"ja"}}}'

範囲と互換性

メタデータと URL を返します。購入、非公開アカウントの参照、ローカルへの書き込みは行いません。チャット内 3D 表示はクライアントに依存します。

公開済みの事実のみを返します。不明値は null です。検証は記録された GLB ハッシュに適用され、性能保証ではありません。

メタデータは Cloudflare 拠点ごとに IP 当たり毎分 120 回のベストエフォート制限を共有します。無料ファイルのアカウント枠ではありません。

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

エラーと再試行

HTTP / JSON-RPC	説明
405	GET from an address bar is unsupported; connect with MCP POST.
406	Accept must include both application/json and text/event-stream.
415	Send JSON with Content-Type: application/json.
403	Browser 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.
413	Messages must fit within 32 KiB; batch messages are unsupported.
429	Wait for Retry-After before retrying.
JSON-RPC / tools/call	Check JSON-RPC error first. If result.isError is true, inspect structuredContent or text for the tool error instead of treating it as success.