OpenAPI x MCP

从 OpenAPI 规范生成类型安全的 MCP (模型上下文协议) 服务器。

CLI 命令

该软件包提供了几个 CLI 命令来管理您的 MCP 服务器：

生成服务器代码

从您的 OpenAPI 规范生成 MCP 服务器代码：

npx -y -p @usemodel-dev/cli@latest cli generate <SPEC_YAML_OR_JSON 的绝对路径>

这将在 cwd() 目录中创建 mcp 服务器文件。

配置 MCP 客户端设置

config 命令提供了两个操作来管理 MCP 服务器配置：

添加或更新配置

为不同的客户端添加或更新 MCP 服务器设置：

npx -y -p @usemodel-dev/cli@latest cli config add <client> '<config_json>'

其中：

• <client> 可以是以下之一：cursor、windsurf 或 claude
• <config_json> 是包含您的配置的 JSON 字符串

示例：

# 为 Cursor 添加或更新服务器配置
npx -y -p @usemodel-dev/cli@latest cli config add cursor '{"@yourorg/mcp": {"url": "http://localhost:3000", "env": { "apiKey": "XXX" } } }'

移除配置

从客户端移除特定的服务器配置：

npx -y -p @usemodel-dev/cli@latest cli config remove <client> <servername>

示例：

# 从 Cursor 移除服务器配置
npx -y -p @usemodel-dev/cli@latest cli config remove cursor @yourorg/mcp

配置存储在以下基于客户端的位置：

• Cursor: ~/.cursor/mcp.json
• Windsurf: ~/.codeium/windsurf/mcp_config.json
• Claude: ~/Library/Application Support/Claude/claude_desktop_config.json

所有配置都存储在配置文件中的 mcpServers 键下。 添加新配置时，它们将与现有配置合并，更新现有配置时，它们将被覆盖。

运行服务器

npx -y  -p @usemodel-dev/cli@latest server

在本地运行服务器

构建服务器

pnpm build

你需要在运行此命令之前运行 generate 命令。

pnpm start

这将在 http:localhost:3001 启动服务器

环境变量

服务器使用 dotenv 进行配置。 在您的项目根目录中创建一个包含必要环境变量的 .env 文件。

依赖项

此软件包使用几个关键依赖项：

• @modelcontextprotocol/sdk: 用于 MCP 实现
• express: 用于服务器框架
• openapi-typescript: 用于 TypeScript 类型生成
• zod: 用于运行时类型验证

贡献

此项目托管在 GitHub 上，地址为 https://github.com/@usemodel-dev/cli.git。 欢迎提出问题或提交 pull request。

许可证

MIT

软件包信息

当前版本：0.0.1