Node Omnibus MCP 服务器

一个全面的模型上下文协议 (MCP) 服务器，提供高级 Node.js 开发工具和自动化功能。

功能

项目管理

• 项目创建：内置支持以下框架的新项目脚手架：
  • React
  • Next.js
  • Express
  • Fastify
  • 纯 Node.js
• TypeScript 集成：自动 TypeScript 配置和设置
• 包管理：智能依赖安装和版本管理

组件生成

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

配置管理

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

文档

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

AI 辅助

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

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Node Omnibus 服务器：

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

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

npm install

使用

该服务器使用标准输入输出上的模型上下文协议进行操作。它可以与任何兼容 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;  // functional 或 class
   }
   

4. git-commit

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

5. debug-error

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

项目结构

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. 分叉仓库
2. 创建功能分支
3. 进行修改
4. 提交拉取请求

许可证

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

要求

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

依赖项

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