jochenyang/mcp-builder
skills/mcp-builder/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add jochenyang/jochen-ai-rules mcp-builderInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 10:13 AM7.6s1 file scanned
SKILL.md
- name:
- mcp-builder
- description:
- 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.
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 testsscripts/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 neededPrimary Deliverable- server design, tool schema, or implementation planExecution Evidence- guides used, files changed, and evaluation steps preparedRisks / Open Questions- permission, schema, or agent-usage concernsNext Action- the next build, test, or review step
Related Skills
jochenyang/reflect
databases
VerifiedTrustedCommunity
Review current conversation, analyze tasks, errors, and user feedback, extract learning opportunities for skill improvement. Use when user says "reflect", "review session", "what did we learn", "session summary", or after completing a complex task.
20SKILL.mdUpdated Apr 6, 2026
jochenyang/handoff
development
VerifiedTrustedCommunity
Create and resume structured manual session handoffs for long-running development work. Use when approaching context limits, before manual reset, before switching models or IDEs, after a milestone, or when automatic compact would lose important implementation state.
20SKILL.mdUpdated Apr 6, 2026
jochenyang/frontend-design
development
VerifiedTrustedCommunity
Implement distinctive, production-grade frontend UI code with strong visual direction, motion systems, local media asset generation, conversion-aware copy, and polished frontend execution. Use when building landing pages, marketing sites, product pages, dashboards, motion-heavy interfaces, or frontend experiences that need real assets and compelling copy.
20SKILL.mdUpdated Apr 6, 2026
jochenyang/context-codebase
development
VerifiedTrustedCommunity
Project context engine for repo orientation, cached handoff, and task-focused code retrieval.
20SKILL.mdUpdated Apr 6, 2026