Node Omnibus MCP 服务器

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

功能

项目管理

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

组件生成

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

配置管理

• 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 的模型上下文协议运行。 它可以与任何 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 or class
   }
   

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. Fork 存储库
2. 创建一个功能分支
3. 进行更改
4. 提交 pull request

许可证

MIT 许可证 - 有关详细信息，请参见 LICENSE 文件

要求

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

依赖项

• @modelcontextprotocol/sdk
• axios
• typescript (dev)