Servidor MCP de ToolBox

Una plataforma de desarrollo de herramientas de automatización impulsada por IA que proporciona:

🧩 Arquitectura modular: recarga en caliente de herramientas a través del directorio src/tools 🤖 Asistencia de IA: motor de IA para conversión de lenguaje natural a plantilla de herramientas 🚀 Capacidades de nivel empresarial: integración de servicios del entorno de producción como MongoDB/Redis/SSH 🔄 Actualizaciones en tiempo real: implementación sin tiempo de inactividad a través de buildReload_tool

Lengua china

Contribuyendo

Pautas de contribución (inglés) Pautas de contribución (chino)

Especificaciones de la herramienta

Características

Herramientas

Vea las especificaciones completas de la herramienta y la documentación detallada: TOOL.md

Recursos

Los recursos se generan dinámicamente al ejecutar la herramienta. Por ejemplo, la herramienta create_note crea un recurso de nota al que se puede acceder mediante su URI.

Herramienta de flujo de trabajo

workflow_tool es una potente herramienta para orquestar flujos de trabajo complejos mediante la interconexión de múltiples herramientas. Admite:

• Ejecución en serie y en paralelo: ejecutar herramientas de forma secuencial o paralela.
• Gestión de Transacciones: Gestionar transacciones con mecanismos de compensación por manejo de errores.
• Informes detallados: genere informes detallados sobre la ejecución del flujo de trabajo, incluido el estado, el tiempo de ejecución y los resultados de cada paso.
• Salida personalizable: especifique un archivo de salida para guardar el informe de ejecución del flujo de trabajo.

Indicaciones

• summarize_notes : genera resúmenes de las notas creadas con la herramienta create_note .

Guía de desarrollo

Agregar nuevas herramientas

Proceso de desarrollo detallado

1. Creación de plantilla: crea un nuevo archivo de herramientas en el directorio src/tools/
2. Verificación de IA: verifica automáticamente el cumplimiento del esquema de parámetros
3. Generación de pruebas: genere casos de prueba basados en la descripción de la función
4. Revisión de seguridad: análisis de código estático y comprobación de dependencias
5. Integración continua: implementación automatizada mediante acciones de GitHub

Ver la guía de desarrollo completa: prompt.md Consulte las implementaciones existentes: Ejemplos de herramientas

Desarrollo

Instalar dependencias:

Construir el servidor:

Para desarrollo con reconstrucción automática:

Envío al mercado

Un kit de herramientas de automatización integrado y perfecto para Claude Desktop

Instalación

Para integrarse con la aplicación Claude Desktop, agregue la siguiente configuración de servidor a:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Ventanas: %APPDATA%/Claude/claude_desktop_config.json

Valores fundamentales

🚀 Automatización de nivel empresarial que aprovecha la configuración de package.json y proporciona:

• Instalación de la herramienta CLI global (comando tbx )
• Motor de programación de flujo de trabajo
• Compatibilidad con múltiples plataformas (Windows/macOS)
• Capacidades de implementación de nube híbrida (MongoDB/Redis/SSH)

🔧 Apto para desarrolladores

• Implementación de TypeScript fuertemente tipado
• Soporte de depuración en tiempo real (indicador --inspect)
• Plantilla de configuración de depuración de VSCode
• Mecanismo de recarga en caliente:
  Implementado llamando buildReload_tool :
  • Actualizaciones sin tiempo de inactividad
  • Análisis automático del árbol de dependencias
  • Comprobación de compatibilidad de versiones
  • Pruebas en entornos sandbox

Depuración

Depurar servidores MCP puede ser complicado debido a su comunicación con stdio. A continuación, se presentan algunos enfoques:

🚧 Descargo de responsabilidad

Datos sensibles

NO CONFIGURE CONTENEDORES CON DATOS CONFIDENCIALES. Esto incluye claves API, contraseñas de bases de datos, etc.

Cualquier dato confidencial intercambiado con el LLM está inherentemente comprometido, a menos que el LLM se esté ejecutando en su máquina local.

Responsabilidad legal ⚠️

• ⚠️ La herramienta se proporciona "tal cual" bajo la licencia MIT sin garantías.
• ⚠️ El desarrollador no se hace responsable de daños directos o indirectos.
• ⚠️ Los usuarios asumen todos los riesgos derivados de configuraciones incorrectas de los contenedores.
• ⚠️ Cualquier uso ilegal o destructivo está estrictamente prohibido.
• ⚠️ Consulte la LICENCIA para conocer los términos completos

1. Inspector de Node.js: inicie el servidor con el indicador --inspect=9229 :

Luego, conéctese al servidor usando Chrome DevTools navegando a chrome://inspect .

2. Inspector MCP: utilice el Inspector MCP , una herramienta de depuración dedicada a la que se puede acceder a través del script npm inspector :
3. Depuración de VSCode

Para depurar con VSCode, cree un archivo .vscode/launch.json con la siguiente configuración:

Luego, inicie el servidor con el indicador --inspect=9229 y adjunte el depurador VSCode.