使用说明
MCPForge——通过可视化界面将OpenAPI规范转换为MCP服务器
它的作用
- 导入任何OpenAPI规范 --粘贴JSON、粘贴YAML或从URL获取,以立即解析和加载API定义
- 可视化端点浏览器 --在可搜索、可过滤的表中使用HTTP方法标记、路径和操作ID浏览每个端点
- 直观地分配MCP类型 --只需单击一次下拉菜单,即可将每个端点分类为工具、资源、资源模板或排除
- 生产级MCP服务器生成 --使用低级服务器API生成服务器,其中包含完整的JSON架构输入架构、per-tool安全性、运行时验证(JSON-Schema-to-zod)、axios HTTP和所有3种传输(stdio/SSE/Streatable HTTP)
- 一键下载 --将准备运行的MCP服务器包导出为可下载的ZIP
- 多项目仪表板 --从单个经过身份验证的工作区管理多个OpenAPI到MCP转换项目
演示
一个3分钟的演练,显示完整的流程-注册、上传OpenAPI规范、探索端点、分配MCP类型、预览生成的代码和下载项目:
问题
如今,将OpenAPI规范转换为MCP(模型上下文协议)服务器需要手动使用CLI工具和手写配置文件。没有可视化工具可以让你导入OpenAPI规范,一目了然地查看所有端点,将它们分类为MCP类型,并生成一个可用的MCP服务器——所有这些都可以从浏览器中完成。MCPForge填补了这一空白。
技术栈
| 层 | 技术 |
|---|---|
| 框架 | Next.js 16(应用路由器) |
| UI | React 19,顺风CSS v4,shadcn/UI |
| 语言 | TypeScript |
| 数据库 | Prisma ORM+SQLite |
| 身份验证 | Auth.js v5(下一次身份验证) |
| 解析 | @apidevtools/swagger解析器 |
| 导出 | JSZip(ZIP生成) |
| 代码显示 | 反应语法高亮显示 |
如何跑步
# 1. Clone the repository
git clone https://github.com/Mrutyunjay-Patil/mcpforge.git
cd mcpforge
# 2. Install dependencies
npm install
# 3. Set up environment variables
cp .env.example .env
# Edit .env with your AUTH_SECRET and database URL
# 4. Initialize the database
npx prisma generate
npx prisma db push
# 5. Seed the database (optional -- creates a demo user)
npx prisma db seed
# 6. Start the development server
npm run dev
打开 http://localhost:3000 在您的浏览器中。
测试
所有测试均由以下人员生成和执行 TestSprite MCP,一种自动测试工具,可根据产品需求文档创建端到端浏览器和API测试。
- 前端:在3次TestSprite运行中生成63个测试脚本,涵盖身份验证、登录页面、导航、仪表板、项目CRUD、端点浏览器、MCP类型管理、搜索/过滤
- 后端:7个测试脚本,涵盖注册验证(201、400、409)和未经授权的访问(401)
- 总共70个测试文件 其中包含测试计划、标准化PRD和执行报告
testsprite_tests/ - 中的所有测试脚本
testsprite_tests/(前端)和testsprite_tests/backend/API
项目结构
mcpforge-app/
src/
app/ # Next.js App Router pages and API routes
components/ # Reusable React components (shadcn/ui based)
lib/ # Shared utilities, auth config, Prisma client
types/ # TypeScript type definitions
prisma/ # Prisma schema and migrations
public/ # Static assets
testsprite_tests/ # TestSprite-generated E2E test scripts and reports
