AppDog
2025.04.19
3
PythonAPI客户端生成MCP服务器开发效率
AppDog是一个Python包，旨在简化与基于OpenAPI的API的交互。它能够自动从OpenAPI规范生成完全类型化的Python客户端，并创建即用型的MCP（模型上下文协议）服务器用于API集成。AppDog支持在单个项目中管理多个API客户端，并提供版本锁定功能。此外，它还提供了一个简单的CLI工具，用于添加、移除、管理API客户端以及安装MCP服务器。
View on GitHub
Overview
基本能力
产品定位
AppDog是一个用于自动生成和管理OpenAPI客户端及MCP服务器的工具，旨在提高开发效率和简化API集成。
核心功能
- 自动从OpenAPI规范生成完全类型化的Python客户端
- 创建即用型的MCP服务器用于API集成
- 在单个项目中管理多个API客户端
- 提供版本锁定功能
- 提供CLI工具用于管理API客户端和MCP服务器
适用场景
- 需要快速集成多个OpenAPI规范的API
- 需要为API生成类型安全的客户端
- 需要创建MCP服务器以简化API交互
- 需要在项目中管理多个API客户端的版本
工具列表
appdog init: 初始化项目appdog add: 添加API客户端appdog list: 列出所有API客户端appdog show: 显示特定API客户端的详细信息appdog sync: 同步API客户端appdog lock: 锁定API客户端版本appdog mcp install: 安装MCP服务器appdog mcp run: 运行MCP服务器appdog mcp dev: 在开发模式下运行MCP服务器
常见问题解答
- Windows用户注意事项: MCP安装命令需要手动编辑生成的Claude配置。
- 资源模板: Claude Desktop目前不支持资源模板（即带参数的资源）。
使用教程
使用依赖
安装AppDog前需要确保已安装Python和uv工具。
uv add appdog
安装教程
- 初始化项目
appdog init
- 添加API客户端
appdog add petstore --uri https://petstore3.swagger.io/api/v3/openapi.json
- 安装MCP服务器
appdog mcp install -n "My API Server"
调试方式
- 运行MCP服务器
appdog mcp run -n "My API Server"
- 在开发模式下运行MCP服务器
appdog mcp dev -n "My API Server"