MCP cover image
See in Github
2025-04-04

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

1

Github Watches

1

Github Forks

3

Github Stars

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)

相关推荐

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Contraband Interactive
  • Emulating Dr. Jordan B. Peterson's style in providing life advice and insights.

  • rustassistant.com
  • Your go-to expert in the Rust ecosystem, specializing in precise code interpretation, up-to-date crate version checking, and in-depth source code analysis. I offer accurate, context-aware insights for all your Rust programming questions.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • modelcontextprotocol
  • Model Context Protocol Servers

  • Mintplex-Labs
  • The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • n8n-io
  • Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

  • open-webui
  • User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

  • WangRongsheng
  • 🧑‍🚀 全世界最好的LLM资料总结(Agent框架、辅助编程、数据处理、模型训练、模型推理、o1 模型、MCP、小语言模型、视觉语言模型) | Summary of the world's best LLM resources.

    Reviews

    2 (1)
    Avatar
    user_T9ysYXdK
    2025-04-16

    I've been using the mcp-node-omnibus-server developed by bsmi021, and I'm genuinely impressed by its efficiency and robustness. The server integrates seamlessly with my applications, providing reliable performance and straightforward configurations. Highly recommend checking it out on GitHub!