Node Omnibus MCP 服务器

一个全面的模型上下文协议（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自动安装Node Omnibus Server到Claude Desktop：

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

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

npm install

使用

该服务器使用Model Context Protocol通过stdio运行。它可以与任何兼容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;    // 特性逗号分隔列表
   }
   

2. analyze-code

   {
     code: string;
     language: string;
   }
   

3. generate-component

   {
     name: string;
     type: string;  // 函数式或类式
   }
   

4. git-commit

   {
     changes: string;  // Git diff或更改描述
   }
   

5. debug-error

   {
     error: string;  // 错误消息或堆栈跟踪
   }
   

项目结构

node-omnibus-server/
├── src/
│   └── index.ts        # 主服务器实现
├── dist/               # 编译后的JavaScript
├── node_modules/       # 依赖项
├── package.json        # 项目配置
└── tsconfig.json      # TypeScript配置

开发

构建

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

// 创建一个新的React项目
const result = await client.callTool('create_project', {
  name: 'my-app',
  type: 'react',
  path: './projects',
  typescript: true
});

// 使用AI辅助进行项目设置
const guidance = await client.getPrompt('create-project', {
  projectType: 'react',
  features: 'typescript,testing,docker'
});

贡献

1. 分叉仓库
2. 创建功能分支
3. 进行修改
4. 提交拉取请求

许可证

MIT许可证 - 查看LICENSE文件获取详细信息

要求

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

依赖项

• @modelcontextprotocol/sdk
• axios
• typescript (开发)