Conversation
python -m underworld3.mcp speaks MCP on stdio and answers questions about runs from their transcripts: the runs under a directory, one run's summary, its steps paged, its step patterns, everything that went wrong or went back, events filtered by kind, part, outcome or step, one step with its attempts, what differs between two steps, the parts that acted, what a part was solving at a step in three levels of detail, the key, the adjoint segments, and any description record rendered in another form. Every tool is a projection of uw.Transcript and the description layer and returns the query's own answer as YAML, so what a model is told is what the digest, a notebook and a test read. Nothing runs a model or writes to one; every tool is annotated read-only. The repository's .mcp.json registers it for Claude Code under the name "underworld" through scripts/mcp-server.sh, which starts it in the checkout's pixi environment. The mcp package (2.x) is not in pixi.toml yet; the guide says how to install it into an environment meanwhile, and the test skips without it. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Na7qBenCp67rDTZhFGTh5V
Member
Author
|
Merged into #790 with the rest of the stack after review; nothing lost, the commits are there. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
python -m underworld3.mcpspeaks MCP on stdio. Thirteen read-only tools, each a projection ofuw.Transcript(#792) and the description layer (#790), returning the query's own answer as YAML:uw_transcript_list,_summary,_steps,_patterns,_problems,_events,_step,_compare,_parts,_part(summary / forms / exact),_key,_adjoint_segments, anduw_describe_render. Apathmay be a transcript file, a run directory, or atranscriptsdirectory for the latest run. Answers are compact by default and drill down on request; the full symbolic forms reach the model only withdetail="exact"..mcp.jsonregisters the server for Claude Code asunderworldthroughscripts/mcp-server.sh, which starts it in the checkout's pixi environment. Themcppackage (2.x, whereFastMCPbecameMCPServer) is not inpixi.tomlyet: the guide says how to install it into an environment meanwhile and the test skips without it. Adding it topixi.tomlis a lock-file change left for a deliberate commit.Checked end to end: a client over stdio through the launcher lists the tools and reads the fault example's run. Stacked on #792.
Tests:
test_0019_mcp_server.py. Docs:docs/developer/guides/mcp-server.md.🤖 Generated with Claude Code
https://claude.ai/code/session_01Na7qBenCp67rDTZhFGTh5V