AppDog
About
Compose and generate effortlessly MCP servers from any OpenAPI specifications
Details
- License
- MIT
Explore
- Generates fully typed async Python clients from OpenAPI specs
- Creates ready-to-use MCP servers for API integrations
- Manages multiple API clients with version locking
- Simple CLI for adding, removing, and managing APIs
- Supports custom authentication via environment variables or headers
- Allows filtering methods and tags during client generation
uv add appdog
appdog mcp install -n "My API Server"
API credentials can be configured using environment variables:
APPDOG_<CLIENT_NAME>_TOKEN=your_token
APPDOG_<CLIENT_NAME>_API_KEY=your_api_key
appdog mcp install [OPTIONS]
--env-var, -v: Environment variables in KEY=VALUE format
- --env-file, -f: Environment file with KEY=VALUE pairs
- --with: Additional packages to install in dev mode
- --with-editable, -e: Local packages to install in editable mode
Create a custom apps.yaml to configure your API clients:
petstore:
uri: https://petstore3.swagger.io/api/v3/openapi.json
base_url: https://petstore3.swagger.io/api/v3
include_tags:
- pet
- store
> For MCP usage, see environment variables section
Create a client with custom authentication:
```python
from appdog.petstore import PetstoreClient
Compose and generate effortlessly async API clients and MCP servers from any OpenAPI specifications.
<br>
<p align="center">
</p>
> Claude Desktop doesn't handle yet resource templates (i.e. resource with parameters).
> For Windows users, MCP Install command needs a manual edit of the generated Claude configuration. See this issue for more details.
Overview
AppDog is a Python package that simplifies working with OpenAPI-based APIs by:
- Automatically generating fully typed Python clients from OpenAPI specifications
- Creating ready-to-use MCP (Model Context Protocol) servers for API integrations
- Managing multiple API clients in a single project with version locking
- Providing a simple CLI for adding, removing, managing API clients, and installing MCP servers
Installation
uv add appdog
Quick Start
Initialize a project
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
