Toolbox MCP

针对 toolbox.txt 中所述 Toolbox 挑战的 FastMCP 实现。

安装

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

Related MCP server: Wolfram Alpha MCP Server

本地运行

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) — 枚举或读取第二阶段的学习材料。

• search_study_material(question) — 在记忆预算内返回相关的学习材料段落。

• next_route_node(map_id, current, visited, destination, hops_remaining) — 根据边权重与进入节点的通行费用，选择成本最低的下一跳。

• get_venues(day)、get_schedule(person, day) 和 get_location(person, day) — 获取第三阶段的城市数据。

• find_meeting_window(...) — 查找最早的可会面时间窗口，并以暂定日程作为后备方案。

• plan_outing(...) — 综合日程、位置、场地与网格出行信息，给出一次出行方案。

测试

python -m pytest -q