Design and deploy Model Context Protocol servers with deep knowledge of the JSON-RPC 2.0 spec, transport mechanisms, and protocol lifecycle. Covers FastMCP framework patterns, production hardening, and diagnostic techniques for connectivity failures. Engage when architecting MCP integrations, building custom servers, or debugging protocol-level issues.
View on GitHubAeyeOps/aeo-skill-marketplace
aeo-architecture
aeo-architecture/skills/mcp-architect-designer/SKILL.md
January 25, 2026
Select agents to install to:
npx add-skill https://github.com/AeyeOps/aeo-skill-marketplace/blob/main/aeo-architecture/skills/mcp-architect-designer/SKILL.md -a claude-code --skill mcp-architect-designerInstallation paths:
.claude/skills/mcp-architect-designer/# MCP Architect Designer ## Overview This skill provides expert guidance for Model Context Protocol (MCP) architecture, design, implementation, and troubleshooting. Combines deep knowledge of the MCP specification (JSON-RPC 2.0, protocol lifecycle, transport mechanisms) with practical expertise in building production-ready MCP servers using the FastMCP framework. Includes comprehensive troubleshooting capabilities for diagnosing and fixing MCP servers that won't start, can't connect, or fail during operation. ## When to Use This Skill This skill applies to tasks involving: - **Building New MCP Servers** - Creating MCP servers from scratch or using templates - **Protocol Compliance** - Ensuring correct JSON-RPC 2.0 implementation and MCP specification adherence - **Framework Selection** - Choosing between FastMCP, custom implementations, or evaluating MCP frameworks - **Transport Configuration** - Setting up HTTP/SSE, stdio, or custom transport layers - **Troubleshooting MCP Issues** - Diagnosing why servers won't start, connections fail, or protocol handshakes break - **Authentication & Security** - Implementing OAuth 2.1, JWT validation, or custom authorization patterns - **Multi-Client Support** - Building servers that work with both OpenAI and Claude (Anthropic) clients - **OWASP Security Compliance** - Meeting security standards for OAuth 2.1 and MCP deployments - **Performance Optimization** - Improving tool execution speed, resource management, and concurrent request handling - **Production Deployment** - Deploying MCP servers with proper security, monitoring, Docker, and reverse proxy configuration - **Architecture Design** - Designing dual REST+MCP interfaces or multi-server MCP architectures ## Quick Reference **Create New Server:** ```bash python scripts/init_mcp_server.py my-server cd my-server pip install -r requirements.txt python server.py ``` **Test Connection:** ```bash python scripts/test_mcp_connection.py http://localhost:8000/mcp ``` **Ba