AI导哈

OpenAPI同步MCP服务器

一个高性能的MCP服务器，用于处理OpenAPI规范，支持解析、差异比较、跟踪依赖关系以及生成代码。

  • by jhlee0409
  • Rust
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 jhlee0409/openapi-sync-mcp

使用说明

OpenAPI同步MCP

适用于OpenAPI规范的高性能MCP服务器。解析、区分、跟踪依赖关系和生成代码——所有这些都可以从你的人工智能助手中完成。

用Rust构建 以实现速度和最小的资源使用。

特性

  • 依赖图 -知道更改模式时哪些端点会中断
  • 智能差异 -在突破性更改投入生产之前检测它们
  • 分页解析 -在没有压倒性背景的情况下处理大量规格
  • 24小时缓存 -支持HTTP缓存的快速重复查询
  • 多目标编码器 -TypeScript、Rust、Python来自一个规范

快速开始

npm install -g @jhlee0409/openapi-sync-mcp

增添 ~/.claude/settings.json:

{
  "mcpServers": {
    "oas": {
      "command": "openapi-sync-mcp"
    }
  }
}

工具

工具 说明
oas_parse 解析并验证OpenAPI规范（带分页）
oas_deps 架构更改时查找受影响的端点
oas_diff 比较两个规范版本，检测突破性更改
oas_status 检查缓存状态
oas_generate 生成Types/Rust/Python代码

代码生成目标

typescript-types · typescript-fetch · typescript-axios · typescript-react-query · rust-serde · rust-reqwest · python-pydantic · python-httpx

安装

# npm (recommended)
npm install -g @jhlee0409/openapi-sync-mcp

# Cargo
cargo install openapi-sync-mcp

# Or download from GitHub Releases

故障排除

服务器没有响应？

chmod +x openapi-sync-mcp
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | openapi-sync-mcp

缓存问题？ 删除 .openapi-sync.cache.json 或使用 use_cache: false.

发展

cargo test          # Run tests
cargo fmt --check   # Check formatting
cargo clippy        # Lint

许可证

麻省理工学院

相关

  • claude插件 -插件命令(/oas:*)用于增强工作流程

相关 MCP