Node Omnibus MCP Server

Node Omnibus MCP 服务

一款功能全面的 Model Context Protocol（MCP）服务，提供高级 Node.js 开发工具和自动化能力。

功能

项目管理

• 项目创建：使用内置支持的模板搭建新项目：
  • React
  • Next.js
  • Express
  • Fastify
  • 纯 Node.js
• TypeScript 集成：自动配置并设置 TypeScript
• 包管理：智能安装依赖并管理版本

组件生成

• 创建 React 组件（函数式或基于类）
• 生成 TypeScript 接口
• 自动定义属性类型
• 生成组件文档

配置管理

• TypeScript 配置管理
• NPM 脚本管理
• 更新 Package.json
• 环境设置

文档

• 生成项目 README
• API 文档
• 组件文档
• TypeScript 类型定义文档

AI 驱动的辅助功能

• 项目创建指导
• 代码分析与改进
• 组件生成辅助
• Git 提交信息建议
• 错误调试辅助

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Node Omnibus Server：

npx -y @smithery/cli install @bsmi021/mcp-node-omnibus-server --client claude

1. 克隆仓库
2. 安装依赖：

npm install

使用方法

该服务通过 stdio 使用 Model Context Protocol 运行，可与任何兼容 MCP 的客户端集成。

启动服务

npm start

可用工具

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;
   }
   

可用提示词

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
   }
   

项目结构

node-omnibus-server/
├── src/
│   └── index.ts        # Main server implementation
├── dist/               # Compiled JavaScript
├── node_modules/       # Dependencies
├── package.json        # Project configuration
└── tsconfig.json      # TypeScript configuration

开发

构建

npm run build

运行测试

npm test

开发模式

npm run dev

集成

VSCode 配置

添加到 VSCode 设置中：

{
  "mcpServers": {
    "node-omnibus": {
      "command": "node",
      "args": ["path/to/node-omnibus-server/dist/index.js"]
    }
  }
}

客户端使用示例

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'
});

贡献

1. Fork 仓库
2. 创建功能分支
3. 进行修改
4. 提交 pull request

许可证

MIT 许可证 — 详情请参阅 LICENSE 文件

要求

• Node.js >= 14.x
• npm >= 6.x
• TypeScript >= 4.x

依赖项

• @modelcontextprotocol/sdk
• axios
• typescript（开发依赖）