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