MCP Server Toolkit

Un conjunto completo de herramientas para desarrollar, probar e implementar servidores del Protocolo de Contexto de Modelo (MCP).

Documentación

MCP Server Toolkit

Un kit de herramientas integral para desarrollar, probar e implementar servidores del Model Context Protocol (MCP).

🚀 Descripción general

Este repositorio proporciona un entorno estructurado para crear servidores MCP listos para producción, con marcos de pruebas integrados, plantillas y documentación.

📁 Estructura de directorios

mcp-server-toolkit/
├── servers/                    # Production-ready MCP servers
│   └── applescript/           # AppleScript execution server
├── testing/                    # Centralized testing framework
│   ├── framework/             # Core test utilities
│   ├── suites/               # Test suites per server
│   └── results/              # Test results (gitignored)
├── development/               # Active development/prototypes
├── templates/                 # Boilerplate for new servers
│   ├── node-mcp-template/    # Node.js server template
│   └── python-mcp-template/  # Python server template
├── docs/                      # Documentation
│   ├── guides/               # How-to guides
│   └── api/                  # API documentation
├── tools/                     # Development utilities
└── _archive/                  # Archived/deprecated items

🏗️ Servidores disponibles

AppleScript MCP Server

Ejecuta comandos de AppleScript a través del protocolo MCP. Permite la interacción con aplicaciones de macOS y funciones del sistema.

  • Ubicación: servers/applescript/
  • Lenguajes: Implementaciones en Node.js y Python
  • Documentación: docs/guides/applescript-permissions-guide.md

🧪 Pruebas

Ejecuta las pruebas de todos los servidores:

cd testing/framework
node test-runner.js

Ejecuta las pruebas de un servidor específico:

cd testing/suites/applescript
./permissions-check.sh

📝 Creación de un nuevo servidor MCP

  1. Elige una plantilla de templates/
  2. Cópiala a development/ para el trabajo inicial
  3. Sigue el README de la plantilla para la configuración
  4. Muévela a servers/ cuando esté lista para producción

🔧 Configuración global

Añade a tu ~/.claude/claude_config.json:

{
  "mcpServers": {
    "applescript": {
      "command": "node",
      "args": ["/path/to/mcp-server-toolkit/servers/applescript/server.js"]
    }
  }
}

📚 Documentación

🤝 Contribuciones

  1. Desarrolla nuevos servidores en development/
  2. Escribe pruebas exhaustivas en testing/suites/
  3. Documenta en docs/
  4. Envía una solicitud de incorporación de cambios cuando esté listo para servers/

📄 Licencia

Los servidores individuales pueden tener sus propias licencias. Consulta el directorio de cada servidor para más detalles.