Unit Expert MCP

Minimal Streamable HTTP MCP server for PlayMCP.

PlayMCP Settings

MCP 이름: Unit Expert(단위전문가)
MCP 식별자: unitExpert
MCP URL: https://unit-expert-mcp.onrender.com/mcp
인증: 없음

HTTP Endpoints

GET  /
GET  /healthz
POST /mcp
GET  /mcp
GET  /scenario
POST /scenario

POST /mcp expects JSON-RPC with:

Accept: application/json, text/event-stream
Content-Type: application/json

Tools

convert_length
convert_weight
convert_temperature
convert_area
convert_volume
list_supported_units

Scenario Control

Open /scenario in a browser to set the server-wide default scenario. The page also shows a live /mcp response preview for the selected scenario.

Use X-MCP-Test-Scenario to override the server-wide state for one request. Omit it for the currently selected scenario.

The selected scenario is stored in process memory, so it resets to ok after a server restart or redeploy.

X-MCP-Test-Scenario: duplicate-tool-name

지원 시나리오:

기본

정책명	시나리오	효과
정상 응답	`ok`	정상 Unit Expert 도구 목록을 반환합니다.

서버 error

정책명	시나리오	효과
인증 조건 - 401	`auth-401`	JSON-RPC 처리 전에 `401 Unauthorized`를 반환합니다.
인증 조건 - 403	`auth-403`	JSON-RPC 처리 전에 `403 Forbidden`을 반환합니다.
MCP 버전 조건 - 최소 지원 버전	`unsupported-min-version`	최소 지원 버전보다 낮은 `protocolVersion: 2024-11-05`를 반환합니다.
툴 목록 조건 - JSON-RPC 에러	`tools-list-error`	`tools/list`에서 JSON-RPC error를 반환합니다.
툴 목록 조건 - null 반환	`tools-list-null`	`tools/list`에서 `tools: null`을 반환합니다.
툴 목록 조건 - 빈 배열 반환	`tools-list-empty`	`tools/list`에서 `tools: []`를 반환합니다.
툴 개수 조건 - 최대 개수	`too-many-tools`	도구 21개를 반환합니다.
응답속도 조건 - 지연	`delayed-response`	OPTIONS가 아닌 `/mcp` 요청을 5초 지연시킵니다.

tool error

정책명	시나리오	효과
툴 이름 조건 - 중복	`duplicate-tool-name`	동일한 `name`을 가진 중복 tool을 반환합니다.
툴 이름 조건 - 허용 문자	`invalid-tool-name-char`	허용되지 않는 문자가 포함된 tool name을 반환합니다.
툴 이름 조건 - 길이	`invalid-tool-name-length`	129자 길이의 tool name을 반환합니다.
툴 필수 속성 - name	`missing-name`	`name`이 없는 tool을 반환합니다.
툴 필수 속성 - description	`missing-description`	`description`이 없는 tool을 반환합니다.
툴 필수 속성 - inputSchema	`missing-input-schema`	`inputSchema`가 없는 tool을 반환합니다.
툴 필수 속성 - annotations	`missing-annotations`	`annotations`가 없는 tool을 반환합니다.
툴 이름 조건 - 금지어	`forbidden-kakao-name`	금지어가 포함된 tool name을 반환합니다.
툴 설명 조건 - 길이	`long-description`	1,051자 `description`을 반환합니다.
툴 설명 조건 - 서비스명	`missing-service-name-in-description`	서비스명이 빠진 `description`을 반환합니다.
툴 annotations 조건 - 필수 힌트	`incomplete-annotations`	필수 필드가 빠진 `annotations`를 반환합니다.

Run Locally

PYTHONPATH=src PORT=8000 python -m unit_expert_mcp.server

Smoke test:

curl -i -X POST http://localhost:8000/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-03-26' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Official SDK 2026 Baseline

The existing unit_expert_mcp.server implementation is the fault-injection server used for 2025/legacy and intentionally invalid scenarios. For a clean 2026-07-28 baseline backed by the official MCP Python SDK, run the separate entrypoint:

pip install ".[sdk2026]"
PYTHONPATH=src PORT=8000 python -m unit_expert_mcp.sdk_2026_server

This starts a Streamable HTTP MCP endpoint at /mcp using the SDK's ASGI app. It exposes the same six Unit Expert tools, but does not implement the scenario UI or malformed-response cases.

Expected Render endpoint:

https://unit-expert-mcp-2026.onrender.com/mcp

Docker:

docker build -f Dockerfile.sdk2026 -t unit-expert-mcp-sdk2026 .
docker run --rm -p 8000:8000 unit-expert-mcp-sdk2026

Test

PYTHONPATH=src python3 -m unittest discover -s tests -p 'test*.py'

Unit Expert MCP

Unit Expert MCP

PlayMCP Settings

HTTP Endpoints

Tools

Scenario Control

기본

서버 error

tool error

Run Locally

Official SDK 2026 Baseline

Test

Latest Blog Posts

MCP directory API