Skip to content

build(mcp): add make inspect target for the MCP Inspector#20

Open
ABazyk wants to merge 1 commit into
corezoid:mainfrom
ABazyk:feat/mcp-inspector-make-target
Open

build(mcp): add make inspect target for the MCP Inspector#20
ABazyk wants to merge 1 commit into
corezoid:mainfrom
ABazyk:feat/mcp-inspector-make-target

Conversation

@ABazyk

@ABazyk ABazyk commented Jun 10, 2026

Copy link
Copy Markdown
Contributor

What

Adds a make inspect target that launches the MCP Inspector — the official browser UI for listing/calling an MCP server's tools and reading its resources by hand — wrapping the stdio server.

make inspect              # local profile (pong-server :9000)
make inspect PROFILE=prod # public gateway

It runs npx @modelcontextprotocol/inspector go run ./cmd/server --profile $(PROFILE) in the mcp-server/ dir, so it picks up .env exactly as the run-* targets do — auth/workspace carry over. Needs Node.js (npx); no global install.

Why

Gives a no-wiring way to poke at the tool surface and resources (e.g. simulator://actor/{id}) without registering the server into a host. The headless --cli mode is also handy for diffing the tool list in CI.

Docs

  • New "Inspecting / debugging with the MCP Inspector" section in the MCP server README (web UI + --cli mode).
  • Added make inspect to the root README dev section and the Makefile-targets help.

Verification

Smoke-tested the full chain via the Inspector's headless CLI — it launched the stdio server and returned the complete tools/list.

🤖 Generated with Claude Code

Wrap the stdio server in `npx @modelcontextprotocol/inspector go run
./cmd/server --profile $(PROFILE)` (PROFILE defaults to local, override
with `make inspect PROFILE=prod`). It reads .env from the module dir like
the run-* targets, so auth/workspace carry over.

Document usage (web UI + headless --cli mode) in the MCP server README
and the root README dev section.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant