Skip to content

donaldfilimon/abi / .claude/skills/mcp-smoke

mcp-smoke

Verified

Build the abi MCP server and smoke-test its JSON-RPC tool surface — start `abi-mcp`, send a `tools/list` over the stdio transport, and assert the frozen 12-tool contract (ai_run, ai_complete, ai_learn, ai_train, wdbx_query, scheduler_stats, scheduler_info, connector_test, gpu_status, plugin_list, wdbx_stats, plugin_run). Use to run/start/smoke-test abi-mcp, verify the MCP tool list, or check the 12-tool contract still holds. Local stdio; the process exits on pipe EOF.

mcp-smoke — assert the MCP server's 12-tool contract

Driver: .agents/skills/mcp-smoke/smoke.sh (paths relative to repo root). Builds release abi-mcp via ./tools/cargo.sh, launches it through mcp/launcher.sh stdio, sends one JSON-RPC tools/list over stdio, and asserts the frozen 12-tool set. Fully local — no network.

The driver overrides inherited store settings with ABI_WDBX_PATH=:memory: and ABI_WDBX_PERSIST=0. Locked builds explicitly use this checkout's target/ directory, even with an inherited CARGO_TARGET_DIR. Python 3 parses the response and checks the JSON-RPC version, request ID, success envelope and tool names. A failed build or server exit fails the smoke.

Run (agent path)

.agents/skills/mcp-smoke/smoke.sh

Prints RESULT: PASS — 12/12 frozen MCP tools present (exit 0) or RESULT: FAIL.

One-liner:

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | ABI_WDBX_PATH=:memory: ABI_WDBX_PERSIST=0 ./mcp/launcher.sh stdio \
  | jq -r '.result.tools[].name'

Gotchas

  • ⚠️ Do NOT count tools with grep -c '"name":' — it returns 13, not 12. Use jq -r '.result.tools[].name' or count only tool-list name values.
  • stdio framing is newline-delimited JSON — not LSP Content-Length.
  • No hang, no timeout needed. Pipe EOF exits the stdio loop.
  • Optional loopback HTTP/SSE may log on stderr; drop stderr when grepping stdout.

Troubleshooting

SymptomFix
build FAIL./tools/cargo.sh build --locked --release -p abi-mcp then ./tools/check.sh
empty responsetrailing \n required; drop stderr
got 13 toolsover-counting schema "name" fields
tool set mismatchreconcile crates/abi-mcp/src/handlers.rs with AGENTS.md frozen list

Historical golden: tests/golden/mcp-tools-list.json.

finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall