OpenAPI 转 MCP 服务器生成工具

将 OpenAPI 规范转换为 Model Context Protocol (MCP) 兼容服务器的命令行工具。

功能特点

• OpenAPI 支持: 支持 OpenAPI 3.0 标准，能够解析并生成 MCP 服务器。
• 代理行为: 实现请求转发功能，支持多种认证方式。
• 认证支持: 包括 API Key、Bearer Token、Basic Auth 和 OAuth2 等多种身份验证方案。
• Zod 验证: 使用 Zod 进行数据验证，确保输入输出的合法性。
• 多种传输模式: 支持标准输入输出（stdio）、基于 SSE 的 Web 服务器和流式 HTTP 传输。

安装指南

npm install -g @your-package-name

使用说明

基本用法

1. 初始化项目：

mcp-server init your-project-name

2. 根据提示完成 OpenAPI 配置文件的填写。

3. 启动服务器：

cd your-project-name
npm start

高级功能

传输模式选择

• stdio 模式: 适用于本地开发和集成到 LLM 工具中。
• Web 服务器（SSE）: 提供基于 SSE 的双向消息通信，支持多连接和浏览器客户端。
• 流式 HTTP 模式: 实现状态ful JSON-RPC，支持完整 HTTP 状态码和头信息。

认证配置

通过环境变量设置认证信息：

项目结构

your-project-name/
├── package.json          # 项目依赖和脚本配置
├── openapi.yaml         # OpenAPI 规范文件
├── config.js            # 服务器配置
└── src/                 # 业务逻辑代码目录

传输模式对比

启动服务器

cd your-project-name
npm install

# 标准输入输出模式
npm start

# Web 服务器模式
npm run start:web

# 流式 HTTP 模式
npm run start:http

Web 模式的测试客户端

1. 启动服务器后，打开浏览器访问 http://localhost:<port>。
2. 使用生成的测试客户端与 MCP 服务器进行交互。

系统要求

• Node.js 版本 v20 或更高版本。

注意: 该项目目前处于开发阶段，可能存在不稳定性和潜在问题。使用前请仔细阅读文档并做好充分测试。