{"id":27999174,"url":"https://github.com/bsmi021/mcp-node-omnibus-server","last_synced_at":"2025-08-09T23:07:41.663Z","repository":{"id":273772898,"uuid":"911635760","full_name":"bsmi021/mcp-node-omnibus-server","owner":"bsmi021","description":"A comprehensive Model Context Protocol (MCP) server that provides advanced Node.js development tooling and automation capabilities.","archived":false,"fork":false,"pushed_at":"2025-04-03T21:40:44.000Z","size":22,"stargazers_count":4,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-21T03:39:49.667Z","etag":null,"topics":["mcp","mcp-server","modelcontextprotocol","node","node-js","nodejs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bsmi021.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-03T13:39:06.000Z","updated_at":"2025-05-15T02:04:29.000Z","dependencies_parsed_at":"2025-04-03T22:25:48.380Z","dependency_job_id":"571fb39a-acee-4165-a04d-acfe922b627d","html_url":"https://github.com/bsmi021/mcp-node-omnibus-server","commit_stats":null,"previous_names":["bsmi021/mcp-node-omnibus-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bsmi021/mcp-node-omnibus-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsmi021%2Fmcp-node-omnibus-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsmi021%2Fmcp-node-omnibus-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsmi021%2Fmcp-node-omnibus-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsmi021%2Fmcp-node-omnibus-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bsmi021","download_url":"https://codeload.github.com/bsmi021/mcp-node-omnibus-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsmi021%2Fmcp-node-omnibus-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269649848,"owners_count":24453541,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-09T02:00:10.424Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp","mcp-server","modelcontextprotocol","node","node-js","nodejs"],"created_at":"2025-05-08T22:56:49.944Z","updated_at":"2025-08-09T23:07:41.610Z","avatar_url":"https://github.com/bsmi021.png","language":"JavaScript","funding_links":[],"categories":["Coding Agents","Task and Project Management","JavaScript"],"sub_categories":["How to Submit"],"readme":"# Node Omnibus MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@bsmi021/mcp-node-omnibus-server)](https://smithery.ai/server/@bsmi021/mcp-node-omnibus-server)\n\nA comprehensive Model Context Protocol (MCP) server that provides advanced Node.js development tooling and automation capabilities.\n\n## Features\n\n### Project Management\n\n- **Project Creation**: Scaffold new projects with built-in support for:\n  - React\n  - Next.js\n  - Express\n  - Fastify\n  - Plain Node.js\n- **TypeScript Integration**: Automatic TypeScript configuration and setup\n- **Package Management**: Smart dependency installation and version management\n\n### Component Generation\n\n- Create React components (functional or class-based)\n- TypeScript interfaces generation\n- Automatic prop types definition\n- Component documentation generation\n\n### Configuration Management\n\n- TypeScript configuration management\n- NPM script management\n- Package.json updates\n- Environment setup\n\n### Documentation\n\n- Project README generation\n- API documentation\n- Component documentation\n- TypeScript type definitions documentation\n\n### AI-Powered Assistance\n\n- Project creation guidance\n- Code analysis and improvements\n- Component generation assistance\n- Git commit message suggestions\n- Error debugging assistance\n\n## Installation\n\n### Installing via Smithery\n\nTo install Node Omnibus Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@bsmi021/mcp-node-omnibus-server):\n\n```bash\nnpx -y @smithery/cli install @bsmi021/mcp-node-omnibus-server --client claude\n```\n\n1. Clone the repository\n2. Install dependencies:\n\n```bash\nnpm install\n```\n\n## Usage\n\nThe server operates using the Model Context Protocol over stdio. It can be integrated with any MCP-compatible client.\n\n### Starting the Server\n\n```bash\nnpm start\n```\n\n### Available Tools\n\n1. `create_project`\n\n   ```typescript\n   {\n     name: string;\n     type: 'react' | 'node' | 'next' | 'express' | 'fastify';\n     path: string;\n     typescript?: boolean;\n   }\n   ```\n\n2. `install_packages`\n\n   ```typescript\n   {\n     packages: string[];\n     path: string;\n     dev?: boolean;\n   }\n   ```\n\n3. `generate_component`\n\n   ```typescript\n   {\n     name: string;\n     path: string;\n     type: 'functional' | 'class';\n     props?: Record\u003cstring, string\u003e;\n   }\n   ```\n\n4. `create_type_definition`\n\n   ```typescript\n   {\n     name: string;\n     path: string;\n     properties: Record\u003cstring, string\u003e;\n   }\n   ```\n\n5. `add_script`\n\n   ```typescript\n   {\n     path: string;\n     name: string;\n     command: string;\n   }\n   ```\n\n6. `update_tsconfig`\n\n   ```typescript\n   {\n     path: string;\n     options: Record\u003cstring, unknown\u003e;\n   }\n   ```\n\n7. `create_documentation`\n\n   ```typescript\n   {\n     path: string;\n     type: 'readme' | 'api' | 'component';\n     name?: string;\n   }\n   ```\n\n### Available Prompts\n\n1. `create-project`\n\n   ```typescript\n   {\n     projectType: string;  // react, node, next, express, fastify\n     features?: string;    // comma-separated list of features\n   }\n   ```\n\n2. `analyze-code`\n\n   ```typescript\n   {\n     code: string;\n     language: string;\n   }\n   ```\n\n3. `generate-component`\n\n   ```typescript\n   {\n     name: string;\n     type: string;  // functional or class\n   }\n   ```\n\n4. `git-commit`\n\n   ```typescript\n   {\n     changes: string;  // Git diff or description of changes\n   }\n   ```\n\n5. `debug-error`\n\n   ```typescript\n   {\n     error: string;  // Error message or stack trace\n   }\n   ```\n\n## Project Structure\n\n```\nnode-omnibus-server/\n├── src/\n│   └── index.ts        # Main server implementation\n├── dist/               # Compiled JavaScript\n├── node_modules/       # Dependencies\n├── package.json        # Project configuration\n└── tsconfig.json      # TypeScript configuration\n```\n\n## Development\n\n### Building\n\n```bash\nnpm run build\n```\n\n### Running Tests\n\n```bash\nnpm test\n```\n\n### Development Mode\n\n```bash\nnpm run dev\n```\n\n## Integration\n\n### VSCode Configuration\n\nAdd to your VSCode settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"node-omnibus\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/node-omnibus-server/dist/index.js\"]\n    }\n  }\n}\n```\n\n### Client Usage Example\n\n```typescript\nconst client = new McpClient();\nawait client.connect(transport);\n\n// Create a new React project\nconst result = await client.callTool('create_project', {\n  name: 'my-app',\n  type: 'react',\n  path: './projects',\n  typescript: true\n});\n\n// Use AI assistance for project setup\nconst guidance = await client.getPrompt('create-project', {\n  projectType: 'react',\n  features: 'typescript,testing,docker'\n});\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## License\n\nMIT License - See LICENSE file for details\n\n## Requirements\n\n- Node.js \u003e= 14.x\n- npm \u003e= 6.x\n- TypeScript \u003e= 4.x\n\n## Dependencies\n\n- @modelcontextprotocol/sdk\n- axios\n- typescript (dev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsmi021%2Fmcp-node-omnibus-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbsmi021%2Fmcp-node-omnibus-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsmi021%2Fmcp-node-omnibus-server/lists"}