Mcp builder

Skill JochenYang/Jochen-ai-rules/skills/mcp-builder

MCP server development for AI agents. Designs tool schemas, implements Python/TypeScript servers, creates evaluation tests. Use when user asks to build MCP server, create tool integration, or develop Claude plugins. Supports GitHub/Notion/Slack integrations.From its SKILL.md

Install

npx -y skills add JochenYang/Jochen-ai-rules --skill mcp-builder

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

20 stars20 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.9 KB, as published. Nobody here has run it

MCP Server Development Tool

Build high-quality Model Context Protocol servers to provide external tool capabilities for AI agents.

Core Capabilities

MCP protocol understanding and server architecture design
Python/TypeScript SDK implementation
Tool schema design for AI agents
Evaluation test creation and validation

Tech Stack

Language	SDK	Validation	Runtime
Python	MCP Python SDK	Pydantic v2	asyncio
TypeScript	MCP TypeScript SDK	Zod	Node.js 18+

Executable Tools

The following scripts can be run directly without reading source code:

scripts/evaluation.py - Run MCP server evaluation tests
scripts/connections.py - Test server connection status

Design Principles

Workflow-Oriented: Build complete task tools, not simple API wrappers
Optimize Context: Return high-signal information, avoid data dumping
Actionable Errors: Error messages guide agents to correct usage
Evaluation-Driven: Create evaluation scenarios early, iterate based on agent feedback

Boundaries

Focus on MCP server development and tool design, not third-party API development or client integration.

When NOT to Use

Writing general business logic code → use developer
Frontend UI development → use frontend-design
API design → use api-designer
Database schema design → use database-engineer
Product planning or requirements → use product-manager

Detailed References

./workflows/mcp-development.md - Complete development workflow
./guides/mcp_best_practices.md - MCP best practices
./guides/python_mcp_server.md - Python implementation guide
./guides/node_mcp_server.md - TypeScript implementation guide
./guides/evaluation.md - Evaluation creation guide

Escalation Rules

Pause and ask the owner before:

exposing tools that have overly broad permissions or weak schema boundaries
expanding server scope into generic third-party API integration work
shipping an MCP interface without at least a basic evaluation or validation path

Final Output Contract (MANDATORY)

Every use of this skill should end with:

Skill Fit - why an MCP server or tool design solution is needed
Primary Deliverable - server design, tool schema, or implementation plan
Execution Evidence - guides used, files changed, and evaluation steps prepared
Risks / Open Questions - permission, schema, or agent-usage concerns
Next Action - the next build, test, or review step