What is Mcp Node Omnibus Server

mcp-node-omnibus-server is a comprehensive Model Context Protocol (MCP) server designed to enhance Node.js development with advanced tooling and automation capabilities.

Use cases

Use cases include scaffolding new projects, generating React components, managing TypeScript configurations, creating documentation, and utilizing AI assistance for code analysis and debugging.

How to use

To use mcp-node-omnibus-server, clone the repository, install dependencies using ‘npm install’, and start the server with ‘npm start’. It operates over stdio and can be integrated with any MCP-compatible client.

Key features

Key features include project management (creation of React, Next.js, Express, Fastify, and Node.js projects), TypeScript integration, component generation, configuration management, documentation generation, and AI-powered assistance for various development tasks.

Where to use

mcp-node-omnibus-server is suitable for web development, particularly for projects using Node.js frameworks and libraries, as well as for teams looking to streamline their development processes.

Node Omnibus MCP Server

A comprehensive Model Context Protocol (MCP) server that provides advanced Node.js development tooling and automation capabilities.

Features

Project Management

• Project Creation: Scaffold new projects with built-in support for:
  • React
  • Next.js
  • Express
  • Fastify
  • Plain Node.js
• TypeScript Integration: Automatic TypeScript configuration and setup
• Package Management: Smart dependency installation and version management

Component Generation

• Create React components (functional or class-based)
• TypeScript interfaces generation
• Automatic prop types definition
• Component documentation generation

Configuration Management

• TypeScript configuration management
• NPM script management
• Package.json updates
• Environment setup

Documentation

• Project README generation
• API documentation
• Component documentation
• TypeScript type definitions documentation

AI-Powered Assistance

• Project creation guidance
• Code analysis and improvements
• Component generation assistance
• Git commit message suggestions
• Error debugging assistance

Installation

Installing via Smithery

To install Node Omnibus Server for Claude Desktop automatically via Smithery:

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

1. Clone the repository
2. Install dependencies:

npm install

Usage

The server operates using the Model Context Protocol over stdio. It can be integrated with any MCP-compatible client.

Starting the Server

npm start

Available Tools

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;
   }
   

Available Prompts

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
   }
   

Project Structure

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

Development

Building

npm run build

Running Tests

npm test

Development Mode

npm run dev

Integration

VSCode Configuration

Add to your VSCode settings:

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

Client Usage Example

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'
});

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

MIT License - See LICENSE file for details

Requirements

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

Dependencies

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