Workspace Protocolo MCP

🔌 MCP Development Workspace

Workspace para desarrollo de servidores MCP (Model Context Protocol).

📁 Estructura

MCP/
├── 📚 conocimiento/           # Base de conocimiento
│   ├── MCP_GUIA_SERVIDOR.md   # Guía consolidada (~150KB)
│   └── mcp_docs_github/       # Documentación detallada por tema
│       ├── quickstart/        # Tutoriales de inicio rápido
│       ├── docs/concepts/     # Arquitectura, tools, resources, prompts
│       ├── docs/tools/        # Inspector, debugging
│       └── tutorials/         # Tutoriales avanzados
│
├── 🧱 plantillas/             # Templates reutilizables
│   ├── python/server_template/    # Plantilla Python completa
│   └── typescript/server_template/ # Plantilla TypeScript completa
│
├── 🏗️ proyectos/              # Servidores para clientes
│   └── (aquí van los proyectos)
│
└── 🔧 utilidades/             # Scripts helper
    └── scrape_mcp_github.py   # Actualizar documentación

🚀 Inicio Rápido

Crear nuevo servidor Python

# Copiar plantilla
cp -r plantillas/python/server_template proyectos/mi-servidor
cd proyectos/mi-servidor

# Instalar dependencias
uv sync  # o: pip install -e ".[dev]"

# Ejecutar en modo desarrollo
uv run mcp dev src/server.py

Crear nuevo servidor TypeScript

# Copiar plantilla
cp -r plantillas/typescript/server_template proyectos/mi-servidor
cd proyectos/mi-servidor

# Instalar y compilar
npm install && npm run build

# Ejecutar con inspector
npm run inspector

📖 Documentación de Referencia

🔧 Actualizar Documentación

cd utilidades
python scrape_mcp_github.py

📋 Checklist Nuevo Proyecto

• [ ] Copiar plantilla apropiada (Python/TypeScript)
• [ ] Renombrar proyecto en pyproject.toml o package.json
• [ ] Definir tools necesarios
• [ ] Implementar lógica de negocio
• [ ] Agregar resources si aplica
• [ ] Agregar prompts si aplica
• [ ] Escribir tests
• [ ] Documentar en README
• [ ] Probar con MCP Inspector
• [ ] Configurar en Claude Desktop

⚠️ Reglas Importantes

1. NUNCA usar print() o console.log() en servidores STDIO
2. Siempre usar logging a stderr
3. Documentar todos los parámetros en docstrings/descripciones
4. Validar inputs antes de procesarlos
5. Manejar errores gracefully

🔗 Enlaces Útiles

• Documentación Oficial MCP
• Repositorio MCP
• MCP Inspector
• Servidores de Ejemplo