智能MCP服务器生成器

Helios是一款智能MCP(模型上下文协议)服务器生成器,通过结合用户意图和API文档,将复杂的API转换为简洁、适合AI代理的工具接口。

  • by acm-projects
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 acm-projects/Helios

使用说明

赫利俄斯

智能MCP(模型上下文协议)服务器生成器。Helios通过将用户意图与API文档相结合,将复杂的API转换为干净、方便代理的工具界面,以生产优化的MCP服务器,从而减少人工智能代理的工具过载。

用户流量

API spec upload → intent description → tool grouping preview → mock server sandbox
    → edit tool catalog → MCP server code generation → download / deploy

堆栈

后端 (backend/)-Node.js,Express,TypeScript,MongoDB via Mongoose,Anthropic Claude API,SwaggerParser。两个过程:

  • api.ts 在端口8000上-面向用户的REST API(身份验证、规范CRUD、沙箱/尝试编排、代码生成)
  • server.ts 在端口3000上——MCP调度器(对真实的目标API执行工具调用)。内部服务;不得公开曝光

前端 (frontend/)——Next.js 16(应用路由器)、React 19、TypeScript、Tailwind CSS v4、shadcn/ui、Monaco编辑器。

回购布局

Helios/
├── backend/                # Express API + MCP dispatcher
│   ├── api.ts              # port 8000 — REST API
│   ├── server.ts           # port 3000 — MCP dispatcher
│   ├── generate_tool_registry.ts  # OpenAPI → tool registry (schema v2)
│   ├── auth/               # JWT + Google OAuth
│   ├── models/             # Mongoose schemas
│   └── scripts/            # premade catalog regen
├── frontend/               # Next.js app
│   ├── app/
│   │   ├── create/         # spec upload + intent
│   │   ├── verify/         # tool catalog editor
│   │   ├── sandbox/        # GET-only mock chat
│   │   ├── try/            # unrestricted live chat
│   │   ├── download/       # ZIP download
│   │   ├── info/           # chapter-based docs
│   │   └── keys/           # per-user API key manager
│   ├── lib/                # shared helpers (auth, provider keys, info summaries)
│   └── public/premade/     # bundled tool catalogs (twilio, etc.)
└── docs/archive/           # historical planning documents

快速启动

后端

cd backend
npm install
# .env must include: MONGODB_URI, JWT_SECRET, ANTHROPIC_API_KEY,
#                    GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, FRONTEND_URL
npx tsx api.ts       # port 8000
npx tsx server.ts    # port 3000 (separate terminal)

前端

cd frontend
npm install
npm run dev          # port 3001 (3000 is taken by the MCP dispatcher)

环境

后端需求 MONGODB_URI, JWT_SECRET, ANTHROPIC_API_KEY, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, FRONTEND_URL,并且可选 NODE_ENV=production 以实现更严格的SSRF防护。

项目状态

分行积极发展 feature-auth-integration公开部署前已知的未完成项目:在端口3000上进行身份验证,在SSRF上进行防护 /api/spec/parse,速率限制,httpOnly cookie迁移。