
OpenAPI-MCP

2025.03.23
0
PythonAPI转换工具语言模型集成开发效率
OpenAPI-MCP是一个工具,用于将OpenAPI规范转换为模型上下文协议(MCP)服务器。它通过在REST API和大型语言模型之间架起桥梁,使得任何通过OpenAPI规范定义的API都可以作为MCP服务器使用,从而让Claude和其他大型语言模型通过模型上下文协议访问这些API。
View on GitHub
Overview
基本能力
产品定位
OpenAPI-MCP旨在简化REST API与大型语言模型之间的交互,通过自动生成MCP服务器,使得API能够被语言模型直接调用。
核心功能
- 将OpenAPI规范转换为MCP服务器
- 生成Python客户端,支持类型注释、数据类和异步操作
- 支持GET、POST、PUT、DELETE等HTTP方法的转换
- 处理路径参数、查询参数和请求体
- 认证处理
- 类型转换(OpenAPI模式到Python类型)
- 提供命令行接口
适用场景
- 开发者希望将现有的REST API暴露给大型语言模型使用
- 需要快速构建API与语言模型交互的中间层
- 自动化API客户端生成
工具列表
openapi-mcp generate
: 生成MCP服务器代码python -m my_api_mcp
: 运行生成的MCP服务器
常见问题解答
- 项目目前处于开发阶段,尚未发布正式版本
- 使用纯Python库,无需外部依赖如npm或Node.js
使用教程
使用依赖
无需额外依赖,仅需Python环境。
安装教程
# 项目尚未发布,安装命令暂不可用
pip install openapi-mcp
调试方式
# 开发环境设置
git clone https://github.com/brukhabtu/openapi-mcp.git
cd openapi-mcp
uv venv
source .venv/bin/activate # Unix-like系统
# 或 .venv\Scripts\activate # Windows
uv pip install -e ".[dev]"
# 运行测试
uv run pytest
# 运行格式化和类型检查
uv run black src tests
uv run mypy src