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
- Clone the repository
- Install dependencies:
Usage
The server operates using the Model Context Protocol over stdio. It can be integrated with any MCP-compatible client.
Starting the Server
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
Running Tests
Development Mode
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)