Openapi X MCP

🚀 OpenAPI and MCP

Generate a type-safe MCP (Model Context Protocol) server from an OpenAPI specification.

Overview

This package allows you to generate and run a type-safe MCP server based on an OpenAPI specification. It provides CLI tools for code generation, configuration management, and server operation.

If you want to use external configurations in your MCP client, you can also add them to your IDE or client with a single command.

🚀 Quick Start

✨ Features

• Generate and run a type - safe MCP server from an OpenAPI specification.
• Provide CLI tools for code generation, configuration management, and server operation.
• Add external configurations to MCP clients with a single command.

📦 Installation

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

💻 Usage Examples

Basic Usage

1. Generate Server Code

Generate MCP server code from an OpenAPI specification:

npx -y -p @usemodel-dev/cli@latest cli generate <ABSOLUTE_PATH_TO_SPEC_YAML_OR_JSON>

This will create MCP server files in the cwd() directory.

Run the Server with npx

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

2. Configure MCP Client Settings

Add or update configurations in your MCP client (e.g., Cursor, Windsurf, etc.):

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

Where:

• <client> can be: cursor, windsurf, or claude.
• <config_json> is a JSON string containing your configuration.

Example:

# Add or update server configuration for Cursor
npx -y -p @usemodel-dev/cli@latest cli config add cursor '{"@yourorg/mcp": {"url": "http://localhost:3000", "env": { "apiKey": "XXX" } } }'

Remove Configuration

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

Example:

# Remove server configuration from Cursor
npx -y -p @usemodel-dev/cli@latest cli config remove cursor @yourorg/mcp

Configuration Storage Location

Depending on the client, configurations are stored in the following locations:

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

All configurations are stored under the mcpServers key in the configuration file. When adding new configurations, they will be merged with existing ones; when updating existing configurations, they will be overwritten.

Advanced Usage

Local Development

1. Build the server:

pnpm build

Note: You need to run the generation command before building.

2. Start the server:

pnpm start

This will start the server at http://localhost:3001.

Environment Variables

The server uses dotenv to manage configurations. Create a .env file in the project root directory and add the necessary environment variables.

🔧 Technical Details

Dependencies

• @modelcontextprotocol/sdk: For MCP implementation.
• express: For the Web server framework.
• openapi-typescript: For TypeScript type generation.
• zod: For runtime type validation.

🤝 Contribution

This project is hosted on GitHub at https://github.com/@usemodel-dev/cli.git. Contributions in the form of issues or pull requests are welcome.

📄 License

MIT

Package Information

Current Version: 0.0.1