About Openapi2mcp
Openapi2mcp is an MCP server published by cosmonic-labs in the Documentation category: run MCP server using OpenAPI spec file.
The repository has 4 stars and 1 forks, with the last commit 5 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/cosmonic-labs/openapi2mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Openapi2mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
OpenAPI to MCP Server Generator
Generate MCP server tools from OpenAPI specifications. Works with mcp-server-template-ts.
Usage
Install via npm
npm install -g openapi2mcp
Or run directly with npx:
npx openapi2mcp <spec.yaml> --project-path <output-dir>
Generate an MCP Server
Start with an MCP project using our template:
git clone https://github.com/cosmonic-labs/mcp-server-template-ts.git my-mcp-server
Generate MCP tools into the server project from an OpenAPI specification:
openapi2mcp path/to/openapi.yaml --project-path my-mcp-server
CLI Options
| Option | Description |
|---|---|
--project-path <path> |
Path to the project root directory (default: .) |
--include-tools <regex> |
Regex pattern for tools to include |
--include-methods <methods> |
Comma-separated HTTP methods to include (e.g., GET,POST) |
--skip-long-tool-names |
Skip tools with names exceeding max length instead of erroring |
--oauth2 |
Enable OAuth2 authentication |
--oauth2-auth-url <url> |
OAuth2 authorization URL (required if --oauth2 is set) |
--oauth2-token-url <url> |
OAuth2 token URL (required if --oauth2 is set) |
--oauth2-refresh-url <url> |
OAuth2 refresh token URL |
Example with Options
openapi2mcp api-spec.yaml \
--project-path ./my-server \
--include-methods GET,POST \
--include-tools "users|products" \
--oauth2 \
--oauth2-auth-url "https://auth.example.com/authorize" \
--oauth2-token-url "https://auth.example.com/token"
Building from Source
Prerequisites
- Rust toolchain with
wasm32-wasip2target - Node.js 18+
- jco
Build
npm install
npm run build
This compiles the Rust code to WASM and transpiles it to JavaScript.
Run from Source
git clone https://github.com/cosmonic-labs/mcp-server-template-ts.git tests/petstore/generated
node index.js tests/petstore/input.json --project-path tests/petstore/generated
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.