Toolbox MCP

toolbox.txt에 설명된 Toolbox 챌린지를 위한 FastMCP 구현입니다.

설치

python -m pip install -e ".[dev]"

Related MCP server: MCP Server Learning

로컬에서 실행

python -m toolbox_mcp.server

MCP 엔드포인트는 http://localhost:8000/mcp입니다. 배포 시 HOST, PORT, 또는 MCP_PATH를 환경 변수로 덮어쓸 수 있습니다.

서버가 제공하는 기능은 다음과 같습니다:

• get_name(name) — 입력된 이름을 검증하고 반환합니다.

• calculate(left, operator, right) — 지원되는 하나의 산술 연산을 계산합니다.

• identify_shape(image_base64) — PNG를 rectangle, triangle, 또는 circle로 식별합니다.

• list_study_materials() / fetch_study_material(document_id) — Phase 2 교안을 나열하거나 읽습니다.

• search_study_material(question) — 검색 예산 내에서 관련 있는 교안 문단을 반환합니다.

• next_route_node(map_id, current, destination, visited, hops_remaining) — 간선 가중치와 노드 진입 통행료를 사용하여 최소 비용 그래프 홉을 선택합니다.

• get_venues(day), get_schedule(person, day), get_location(person, day) — Phase 3 도시 데이터를 가져옵니다.

• find_meeting_window(...) — 가장 이른 빈 시간대를 찾고, 실패 시 임시 수신 약속을 대안으로 사용합니다.

• plan_outing(...) — 일정, 위치, 장소, 그리드 이동을 결합하여 하나의 외출 계획 답변으로 만듭니다.

테스트

python -m pytest -q