https://github.com/bsmi021/mcp-node-omnibus-server
A comprehensive Model Context Protocol (MCP) server that provides advanced Node.js development tooling and automation capabilities.
https://github.com/bsmi021/mcp-node-omnibus-server
mcp mcp-server modelcontextprotocol node node-js nodejs
Last synced: about 2 months ago
JSON representation
A comprehensive Model Context Protocol (MCP) server that provides advanced Node.js development tooling and automation capabilities.
- Host: GitHub
- URL: https://github.com/bsmi021/mcp-node-omnibus-server
- Owner: bsmi021
- License: mit
- Created: 2025-01-03T13:39:06.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-04-03T21:40:44.000Z (6 months ago)
- Last Synced: 2025-06-21T03:39:49.667Z (4 months ago)
- Topics: mcp, mcp-server, modelcontextprotocol, node, node-js, nodejs
- Language: JavaScript
- Homepage:
- Size: 21.5 KB
- Stars: 4
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Node Omnibus Server - Automates Node.js project setup, component generation, and TypeScript integration, providing tooling for frameworks like React and Next.js. Facilitates smart dependency management and automatic configuration for efficient development workflows. (Developer Tools)
README
# Node Omnibus MCP Server
[](https://smithery.ai/server/@bsmi021/mcp-node-omnibus-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](https://smithery.ai/server/@bsmi021/mcp-node-omnibus-server):
```bash
npx -y @smithery/cli install @bsmi021/mcp-node-omnibus-server --client claude
```
1. Clone the repository
2. Install dependencies:
```bash
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
```bash
npm start
```
### Available Tools
1. `create_project`
```typescript
{
name: string;
type: 'react' | 'node' | 'next' | 'express' | 'fastify';
path: string;
typescript?: boolean;
}
```
2. `install_packages`
```typescript
{
packages: string[];
path: string;
dev?: boolean;
}
```
3. `generate_component`
```typescript
{
name: string;
path: string;
type: 'functional' | 'class';
props?: Record;
}
```
4. `create_type_definition`
```typescript
{
name: string;
path: string;
properties: Record;
}
```
5. `add_script`
```typescript
{
path: string;
name: string;
command: string;
}
```
6. `update_tsconfig`
```typescript
{
path: string;
options: Record;
}
```
7. `create_documentation`
```typescript
{
path: string;
type: 'readme' | 'api' | 'component';
name?: string;
}
```
### Available Prompts
1. `create-project`
```typescript
{
projectType: string; // react, node, next, express, fastify
features?: string; // comma-separated list of features
}
```
2. `analyze-code`
```typescript
{
code: string;
language: string;
}
```
3. `generate-component`
```typescript
{
name: string;
type: string; // functional or class
}
```
4. `git-commit`
```typescript
{
changes: string; // Git diff or description of changes
}
```
5. `debug-error`
```typescript
{
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
```bash
npm run build
```
### Running Tests
```bash
npm test
```
### Development Mode
```bash
npm run dev
```
## Integration
### VSCode Configuration
Add to your VSCode settings:
```json
{
"mcpServers": {
"node-omnibus": {
"command": "node",
"args": ["path/to/node-omnibus-server/dist/index.js"]
}
}
}
```
### Client Usage Example
```typescript
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)