From d986442e8e4bc2d716c9d63159a1cfa7b1e6ed76 Mon Sep 17 00:00:00 2001 From: main Date: Sun, 22 Mar 2026 22:20:17 -0400 Subject: Bootstrap consultative Claude Code MCP --- README.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..86c66f6 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +# phone_opus + +`phone_opus` is a deliberately narrow MCP server for consultative Claude Code +calls. + +It exposes one blocking domain tool: + +- `consult`: run the system `claude` install in print mode, wait for the answer, + and return the response plus execution metadata + +The server keeps the public MCP session in a durable host, isolates the actual +Claude invocation in a disposable worker, and ships standard health and +telemetry surfaces: + +- `health_snapshot` +- `telemetry_snapshot` + +## Runtime posture + +Each `consult` call runs Claude Code with: + +- the system `claude` binary +- the normal settings stack, including user-level defaults +- no configured MCP servers (`--strict-mcp-config --mcp-config '{"mcpServers":{}}'`) +- a read-only built-in toolset: + - `Bash,Read,Grep,Glob,LS,WebFetch,WebSearch` +- `--permission-mode dontAsk`, so only preapproved read-only Bash patterns can + execute and edit tools never appear in the session + +## Development + +Run the fast gate with: + +```bash +python check.py +``` + +Run the server locally with: + +```bash +cargo run -- mcp serve +``` + -- cgit v1.2.3