
mcp-builder
Build MCP servers for external APIs and services.
- version
- 0.1.6
- GitHub stars
- 347
Install
/plugin install mcp-builder@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
MCP Builder
Build MCP servers that expose external systems through clear, reliable tools. Default to TypeScript MCP SDK for new servers unless repo language or user request points to Python/FastMCP.
Workflow
- Define target users, target API/service, auth model, transport, and whether server is local stdio or remote Streamable HTTP.
- Read current MCP docs when protocol details matter:
https://modelcontextprotocol.io/sitemap.xml, then relevant.mdpages. - Read only relevant bundled references:
reference/mcp_best_practices.md: universal design rules.reference/node_mcp_server.md: TypeScript server implementation.reference/python_mcp_server.md: Python/FastMCP implementation.reference/evaluation.md: evaluation design and runner usage.
- Map service API into tools. Prefer broad endpoint coverage with a few workflow tools only where they remove real multi-call friction.
- Implement shared API client, auth, pagination, error handling, and response formatting before adding many tools.
- For each tool, provide precise name, concise description, constrained input
schema, structured output where supported, pagination, and annotations:
readOnlyHint,destructiveHint,idempotentHint,openWorldHint. - Test build/lint plus MCP Inspector. Add evaluations for realistic read-only tasks when server behavior must be proven.
Quality Bar
- Tool names are action-oriented and consistently prefixed.
- Errors tell agent what failed and what to try next.
- Large result sets are filtered, paginated, or summarized.
- Auth secrets come from environment or secret manager, never source.
- Mutating tools make risk obvious in name, schema, annotations, and response.
- No duplicated endpoint glue when a shared helper is enough.
Scripts
Use scripts directly before reading them:
scripts/connections.py: connection helpers.scripts/evaluation.py: run evaluation XML against server.scripts/example_evaluation.xml: starter evaluation fixture.scripts/requirements.txt: Python dependencies for evaluation tooling.
Run script --help first when available.
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/mcp-builder
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- memory-profilerv0.1.6
- microsoft-teamsv0.1.0
- nix-toolkitv0.4.12
- okf-memoryv0.1.6
- performance-forensicsv0.1.4
- planning-with-filesv0.1.9
- program-orchestrationv0.1.5
- recallv0.1.7
- requirements-interviewv0.1.4
- researchv0.1.3
- rust-toolkitv0.1.6
- sarif-toolkitv0.1.5
- security-toolkitv0.1.7
- show-me-your-workv0.1.7
- skill-creatorv0.1.8
- software-engineeringv0.1.9
- tddv0.1.4
- technical-writingv0.2.0
- to-specv0.1.1
- to-ticketsv0.1.1
- typescript-best-practicesv0.1.6
- unslopv0.1.7
- verification-harnessv0.1.5
- whyv0.1.6