Skip to main content
Glama
kdaehun00

Unit Expert MCP

by kdaehun00
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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
인증: 없음

Related MCP server: Unit Converter AI MCP Server

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'

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Unit Converter MCP

    zazencodes
    A
    license
    A
    quality
    C
    maintenance
    Provides precise conversions between different units of measurement including temperature, length, weight, and volume.
    16
    8
    MIT

  • Unit Converter AI MCP Server

    CSOAI-ORG
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables unit conversion for length, weight, temperature, and currency using simple tools, with a free tier and paid upgrade for higher usage.
    7 npm
    28 PyPI
    MIT

  • mcp-gnu-units

    laszlopere
    A
    license
    A
    quality
    C
    maintenance
    Unit converter for AI agents, powered by the GNU units database — convert 3000+ units of measurement, evaluate compound unit expressions, reduce to SI base units, dimensional analysis. Offline, deterministic.
    6
    1
    GPL 3.0

  • unit-converter

    Br0ski777
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to convert between measurement units across length, weight, temperature, volume, speed, and data storage, with formulas included. Supports pay-per-call access via x402 micropayments without API keys or signup.
    MIT