Unit Expert

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

Test

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