JADE REALMS / 개발자 문서

MCP 연결 안내

원격 Streamable HTTP를 지원하는 클라이언트에 아래 URL을 추가하고 인증 없음을 선택한 뒤 도구를 검색하세요. 브라우저를 계속 열어 둘 필요가 없습니다.

v1.0.0읽기 전용 · API 키 불필요OpenAPI JSON ↗

연결 단계

원격 Streamable HTTP를 지원하는 클라이언트에 아래 URL을 추가하고 인증 없음을 선택한 뒤 도구를 검색하세요. 브라우저를 계속 열어 둘 필요가 없습니다.

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": "ko"
  }
}

클라이언트 예시

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": "ko"
    }
  });
  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":"ko"}}}'

범위 및 호환성

메타데이터와 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.