Repository navigation
v0.6.1 - MCP improvements
GnawTreeWriter — Release Notes (v0.6.1)
Date: 2026-01-07
Type: Patch Release
Overview
v0.6.1 is a patch release focused on improving the MCP (Model Context Protocol) experience: better documentation, reproducible example clients, broader integration tests, and CI coverage that exercises the examples. It also includes a set of small cleanups and lint/test fixes to make the mcp feature robust for both local development and CI.
Added
- docs/MCP.md — detailed MCP server documentation
- Protocol description, supported methods, authentication, examples and extension guide (how to add tools).
- Example clients
examples/python_mcp_client.py— simple, opinionated Python CLI demonstratinginitialize,tools/list,tools/call(analyze).examples/README.md— how to run the examples and quick usage tips.
- Integration tests:
- Added tests for
tools/list,tools/call(analyze success),tools/call(missing args),tools/call(batch),tools/call(undo), and a concurrency test. - These are under
tests/mcp_integration.rsand are executed when themcpfeature is enabled.
- Added tests for
- CI workflow:
.github/workflows/mcp-examples.yml— new GitHub Actions job that builds with themcpfeature, starts a temporary local MCP server, and runs the Python example (smoke tests) — ensures examples remain functional.
Fixed
- Clippy & build issues for the
mcpfeature:- Corrected imports and brought
towerintodev-dependenciesfor tests (soServiceExt::oneshotworks in test scope). - Resolved clippy warnings by reworking helper functions and usages (
find_symbols_in_tree,find_symbols_in_directory, and related changes). - Fixed argument parsing and format string issues in example client code.
- Corrected imports and brought
- Cleanups:
- Removed accidental or temporary files from repository and stopped tracking session-specific files (added
.gnawtreewriter_session.jsonto.gitignore). - Minor test fixes and improved stability for ephemeral server tests.
- Removed accidental or temporary files from repository and stopped tracking session-specific files (added
Changed
- README.md:
- Added a short MCP Server section and a link to the new
docs/MCP.md.
- Added a short MCP Server section and a link to the new
- CLI help:
- Improved
clapdoc comments for themcpsubcommands sognawtreewriter --helpandgnawtreewriter mcp serve --helpare more informative.
- Improved
- CHANGELOG.md:
- Updated: added a summary of the MCP improvements and example/CI additions.
Testing & Verification
- Local verification:
cargo test --features mcp→ all unit & integration tests passed.cargo clippy --features mcp --all-targets -- -D warnings→ no warnings.
- CI:
- New
mcp-examplesworkflow starts the server in a temporary environment and runs minimal smoke tests to ensure examples are working across pushes and PRs.
- New
Release & Tags
- Tag:
v0.6.1(created and pushed) - Release notes are available in this file and the GitHub release for
v0.6.1.
How to try the MCP examples locally
-
Build & run MCP server (local test):
cargo build --features mcp --release./target/release/gnawtreewriter mcp serve --addr 127.0.0.1:8080 --token secret
-
Python example:
pip install requestspython examples/python_mcp_client.py --url http://127.0.0.1:8080/ --token secret listpython examples/python_mcp_client.py --url http://127.0.0.1:8080/ --token secret analyze examples/foo.py
-
Integration tests (run locally):
cargo test --features mcp
Notes & Next Steps
- Suggested follow-ups (can do in subsequent patch or minor releases):
- Add a small smoke-test CI job that executes both Python and Rust examples (Rust example is optionally available; current smoke test focuses on Python stability).
- Consider converting tool-level errors to structured JSON-RPC error objects for some classes of errors (while keeping the UX-friendly
result.contentfor agent readouts). - Add a small example in Node.js (JS) to broaden language coverage.
- Extend integration tests with a
batchend-to-end test that verifies rollback semantics in failure scenarios.
Thank you to everyone who contributed to getting this shipped — documentation, tests, examples and CI together make the MCP feature more reliable and easier to adopt.