MCP服务器开发工作区

一个用于MCP(模型上下文协议)服务器开发的工作区,提供模板、工具和文档支持。

  • by walteru
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 walteru/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

Archivo Descripción
conocimiento/MCP_GUIA_SERVIDOR.md Guía completa consolidada
conocimiento/mcp_docs_github/quickstart/server.md Tutorial paso a paso
conocimiento/mcp_docs_github/docs/concepts/tools.md Referencia de Tools
conocimiento/mcp_docs_github/docs/concepts/resources.md Referencia de Resources
conocimiento/mcp_docs_github/docs/concepts/prompts.md Referencia de Prompts

🔧 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