OpenAPI-MCP

OpenAPI-MCP

site icon
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

许可证

该项目遵循 MIT 开源许可条款。