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

Clone the repository
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

create_project
{ name: string; type: 'react' | 'node' | 'next' | 'express' | 'fastify'; path: string; typescript?: boolean; }
install_packages
{ packages: string[]; path: string; dev?: boolean; }
generate_component
{ name: string; path: string; type: 'functional' | 'class'; props?: Record<string, string>; }
create_type_definition
{ name: string; path: string; properties: Record<string, string>; }
add_script
{ path: string; name: string; command: string; }
update_tsconfig
{ path: string; options: Record<string, unknown>; }
create_documentation
{ path: string; type: 'readme' | 'api' | 'component'; name?: string; }

Available Prompts

create-project
{ projectType: string; // react, node, next, express, fastify features?: string; // comma-separated list of features }
analyze-code
{ code: string; language: string; }
generate-component
{ name: string; type: string; // functional or class }
git-commit
{ changes: string; // Git diff or description of changes }
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

Fork the repository
Create a feature branch
Make your changes
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)