Node Omnibus Server

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

Installation

Installing for Claude Desktop

Manual Configuration Required

This MCP server requires manual configuration. Run the command below to open your configuration file:

npx mcpbar@latest edit -c claude

This will open your configuration file where you can add the Node Omnibus Server MCP server manually.

Node Omnibus MCP Server

smithery badge

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)
Share:
Details:
  • Stars


    4
  • Forks


    3
  • Last commit


    4 months ago
  • Repository age


    7 months
  • License


    MIT
View Repository

Auto-fetched from GitHub .