Node Omnibus MCP Server

by bsmi021

Integrations

  • Enables creation of Express projects with automatic configuration

  • Provides built-in support for scaffolding Fastify projects

  • Provides AI-powered assistance for Git commit message suggestions

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)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.

  1. Features
    1. Project Management
    2. Component Generation
    3. Configuration Management
    4. Documentation
    5. AI-Powered Assistance
  2. Installation
    1. Installing via Smithery
  3. Usage
    1. Starting the Server
    2. Available Tools
    3. Available Prompts
  4. Project Structure
    1. Development
      1. Building
      2. Running Tests
      3. Development Mode
    2. Integration
      1. VSCode Configuration
      2. Client Usage Example
    3. Contributing
      1. License
        1. Requirements
          1. Dependencies

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              An unofficial JavaScript SDK to create customized servers for the Model Context Protocol, allowing definition of prompts, resources, and tools for tailored interactions.
              Last updated -
              6
              2
              JavaScript
              Apache 2.0
              • Linux
              • Apple
            • A
              security
              A
              license
              A
              quality
              Node.js server implementing Model Context Protocol that enables interaction with TaskWarrior through natural language to view, filter, add, and complete tasks.
              Last updated -
              3
              13
              1
              JavaScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              A TypeScript implementation of a Model Context Protocol server that provides a frictionless framework for developers to build and deploy AI tools and prompts, focusing on developer experience with zero boilerplate and automatic tool registration.
              Last updated -
              6
              TypeScript
              MIT License
            • -
              security
              F
              license
              -
              quality
              A Node.js application that provides a Model Context Protocol server for interacting with Harbor container registry, supporting operations for projects, repositories, tags, and Helm charts.
              Last updated -
              TypeScript

            View all related MCP servers

            ID: 0j9a4m75vv