AppDog - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

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工具。

bash
uv add appdog

安装教程

1. 初始化项目
   bash
appdog init

2. 添加API客户端
   bash
appdog add petstore --uri https://petstore3.swagger.io/api/v3/openapi.json

3. 安装MCP服务器
   bash
appdog mcp install -n "My API Server"

调试方式

1. 运行MCP服务器
   bash
appdog mcp run -n "My API Server"

2. 在开发模式下运行MCP服务器
   bash
appdog mcp dev -n "My API Server"