Releases: nolte/reachy-mini-mcp
Releases · nolte/reachy-mini-mcp
Release list
v0.1.1
Changes
- No changes
Project context
Audiences served
- Reachy Mini owners / developers → addressed by §Runtime requirements, §Migration notes for operators
- Reachy Mini hardware (safety boundary) → addressed by §Hardware support
Runtime requirements
- Python
>=3.12is now the floor for the runtime (pyproject.toml, commit a347af9). - Pinned runtime dependencies:
mcp>=1.2.0,httpx>=0.27.0(commit d4a3858,requirements.txt). - Distribution remains the Docker image built from the repo
Dockerfile; the audit log is written under${XDG_CACHE_HOME}/reachy-mini-mcp/(commit a347af9,src/reachy_mini_mcp/server.py). - The daemon URL is configured via
REACHY_MINI_DAEMON_URL, defaulting tohttp://127.0.0.1:8000(commits a347af9, b50b44a). - A reachable Pollen
reachy-minidaemon on the configured URL is an external precondition.
Migration notes for operators
- This is the initial release line; no prior version to migrate from.
- The shipped
.mcp.jsoncarries the localhost default forREACHY_MINI_DAEMON_URL(commit a347af9); operators using a non-localhost daemon (e.g. Wireless mDNShttp://reachy-mini.local:8000) must override the env var explicitly. - The audit-log directory under
${XDG_CACHE_HOME}/reachy-mini-mcp/must be writable by the container'smcpuser; the default Docker run command bind-mounts${HOME}/.cache/reachy-mini-mcp(.mcp.json).
Hardware support
- Tier-1 read-only tools implemented in this release:
health_check,get_motor_status(commits a347af9, c954b7b,src/reachy_mini_mcp/server.py). Tier-2 (motion-safe) and Tier-3 (motion-active) tools are not yet implemented. - Platform coverage (Wireless / Lite / Simulation) has not been end-to-end validated against this server in CI; see open question below.
- The safety-boundary contract from the canonical spec (
spec/reachy-mini/mcp-server/de.md) — pose-range validation againstcontrol-surface, safe-torque wrapping around motor toggles, audit trail per invocation — applies once tier-2/3 tools land; the tier-1 read surface inherits no write-side gates.
Open questions
- The Python-application section bundle does not directly address four primary audiences from
AUDIENCES.md: MCP clients, Repository maintainer, Pollen Robotics, Anthropic / MCP spec maintainers. Future bundle iterations should add audience-targeted sections (e.g. tool-inventory diff for MCP clients, daemon-endpoint coverage for Pollen, MCP capability-handshake notes for Anthropic). - Spec-drift mechanism between this implementation and
spec/reachy-mini/mcp-server/{de,en}.mdremains informal (AUDIENCES.md§Open questions). - Tier-2 / Tier-3 tool implementation is pending and gates the hardware-support story above.