About Openapi Sync MCP
Openapi Sync MCP is an MCP server in the Documentation category: openAPI Sync MCP Server - Parse, validate, and generate code from OpenAPI specs.
Install
git clone https://github.com/jhlee0409/openapi-sync-mcpThis 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.
Tools (5)
oas_depsFind affected endpoints when a schema changes
Parameters not published.
oas_diffCompare two spec versions, detect breaking changes
Parameters not published.
oas_generateGenerate TypeScript/Rust/Python code
Parameters not published.
oas_parseParse and validate OpenAPI spec (with pagination)
Parameters not published.
oas_statusCheck cache status
Parameters not published.
Ask AI
Ask AI about Openapi Sync MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
OpenAPI Sync MCP
A high-performance MCP server for OpenAPI specifications. Parse, diff, track dependencies, and generate code - all from your AI assistant.
Built with Rust for speed and minimal resource usage.
Features
- Dependency Graph - Know which endpoints break when you change a schema
- Smart Diff - Detect breaking changes before they hit production
- Paginated Parsing - Handle massive specs without overwhelming context
- 24h Cache - Fast repeated queries with HTTP cache support
- Multi-target Codegen - TypeScript, Rust, Python from one spec
Quick Start
npm install -g @jhlee0409/openapi-sync-mcp
Add to ~/.claude/settings.json:
{
"mcpServers": {
"oas": {
"command": "openapi-sync-mcp"
}
}
}
Tools
| Tool | Description |
|---|---|
oas_parse |
Parse and validate OpenAPI spec (with pagination) |
oas_deps |
Find affected endpoints when a schema changes |
oas_diff |
Compare two spec versions, detect breaking changes |
oas_status |
Check cache status |
oas_generate |
Generate TypeScript/Rust/Python code |
Code Generation Targets
typescript-types · typescript-fetch · typescript-axios · typescript-react-query · rust-serde · rust-reqwest · python-pydantic · python-httpx
Installation
# npm (recommended)
npm install -g @jhlee0409/openapi-sync-mcp
# Cargo
cargo install openapi-sync-mcp
# Or download from GitHub Releases
Troubleshooting
Server not responding?
chmod +x openapi-sync-mcp
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | openapi-sync-mcp
Cache issues?
Delete .openapi-sync.cache.json or use use_cache: false.
Development
cargo test # Run tests
cargo fmt --check # Check formatting
cargo clippy # Lint
License
MIT
Related
- claude-plugins - Plugin commands (
/oas:*) for enhanced workflow
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.