Node Omnibus MCP Server

Node Omnibus MCP Server

Un servidor integral del Protocolo de Contexto de Modelo (MCP) que proporciona herramientas avanzadas de desarrollo Node.js y capacidades de automatización.

Características

Gestión de Proyectos

• Creación de Proyectos: Crea nuevos proyectos con soporte integrado para:
  • React
  • Next.js
  • Express
  • Fastify
  • Node.js puro
• Integración de TypeScript: Configuración y preparación automática de TypeScript
• Gestión de Paquetes: Instalación inteligente de dependencias y gestión de versiones

Generación de Componentes

• Crea componentes React (funcionales o basados en clases)
• Generación de interfaces TypeScript
• Definición automática de tipos de props
• Generación de documentación de componentes

Gestión de Configuración

• Gestión de configuración de TypeScript
• Gestión de scripts NPM
• Actualizaciones de Package.json
• Configuración del entorno

Documentación

• Generación de README de proyectos
• Documentación de API
• Documentación de componentes
• Documentación de definiciones de tipos TypeScript

Asistencia con IA

• Orientación para la creación de proyectos
• Análisis y mejoras de código
• Asistencia en la generación de componentes
• Sugerencias de mensajes de commit de Git
• Asistencia para depuración de errores

Instalación

Instalación mediante Smithery

Para instalar Node Omnibus Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @bsmi021/mcp-node-omnibus-server --client claude

1. Clona el repositorio
2. Instala las dependencias:

npm install

Uso

El servidor opera utilizando el Protocolo de Contexto de Modelo a través de stdio. Puede integrarse con cualquier cliente compatible con MCP.

Iniciando el Servidor

npm start

Herramientas Disponibles

1. create_project

   {
     name: string;
     type: 'react' | 'node' | 'next' | 'express' | 'fastify';
     path: string;
     typescript?: boolean;
   }
   

2. install_packages

   {
     packages: string[];
     path: string;
     dev?: boolean;
   }
   

3. generate_component

   {
     name: string;
     path: string;
     type: 'functional' | 'class';
     props?: Record<string, string>;
   }
   

4. create_type_definition

   {
     name: string;
     path: string;
     properties: Record<string, string>;
   }
   

5. add_script

   {
     path: string;
     name: string;
     command: string;
   }
   

6. update_tsconfig

   {
     path: string;
     options: Record<string, unknown>;
   }
   

7. create_documentation

   {
     path: string;
     type: 'readme' | 'api' | 'component';
     name?: string;
   }
   

Prompts Disponibles

1. create-project

   {
     projectType: string;  // react, node, next, express, fastify
     features?: string;    // comma-separated list of features
   }
   

2. analyze-code

   {
     code: string;
     language: string;
   }
   

3. generate-component

   {
     name: string;
     type: string;  // functional or class
   }
   

4. git-commit

   {
     changes: string;  // Git diff or description of changes
   }
   

5. debug-error

   {
     error: string;  // Error message or stack trace
   }
   

Estructura del Proyecto

node-omnibus-server/
├── src/
│   └── index.ts        # Main server implementation
├── dist/               # Compiled JavaScript
├── node_modules/       # Dependencies
├── package.json        # Project configuration
└── tsconfig.json      # TypeScript configuration

Desarrollo

Compilación

npm run build

Ejecutando Pruebas

npm test

Modo de Desarrollo

npm run dev

Integración

Configuración de VSCode

Añade a tu configuración de VSCode:

{
  "mcpServers": {
    "node-omnibus": {
      "command": "node",
      "args": ["path/to/node-omnibus-server/dist/index.js"]
    }
  }
}

Ejemplo de Uso con Cliente

const client = new McpClient();
await client.connect(transport);

// Create a new React project
const result = await client.callTool('create_project', {
  name: 'my-app',
  type: 'react',
  path: './projects',
  typescript: true
});

// Use AI assistance for project setup
const guidance = await client.getPrompt('create-project', {
  projectType: 'react',
  features: 'typescript,testing,docker'
});

Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características
3. Realiza tus cambios
4. Envía una solicitud de extracción (pull request)

Licencia

Licencia MIT - Consulta el archivo LICENSE para más detalles

Requisitos

• Node.js >= 14.x
• npm >= 6.x
• TypeScript >= 4.x

Dependencias

• @modelcontextprotocol/sdk
• axios
• typescript (dev)