# MCPify

Point it at API docs, get an MCP server.

MCPify scrapes API documentation, uses Gemini to figure out the endpoints/auth/params, and spits out a config file. The runtime reads that config and runs an [MCP](https://modelcontextprotocol.io/) server that Claude (or any MCP client) can use to call the API.

## Installation

```bash
git clone https://github.com/yourusername/mcpify.git
cd mcpify
pip install -e .
```

Needs Python 3.11+ and a [Gemini API key](https://aistudio.google.com/).

## Usage

```bash
export GEMINI_API_KEY="your-api-key"

# Parse docs into a config file
mcpify parse https://api.example.com/docs -o my-api.json

# Run the server
mcpify serve my-api.json --auth "your-api-token"

# Or do both at once
mcpify quickstart https://api.example.com/docs --auth "token"
```

To use with Claude Desktop, add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "my-api": {
      "command": "mcpify",
      "args": ["serve", "/path/to/my-api.json", "--auth", "your-token"]
    }
  }
}
```

## CLI

**`mcpify parse <url>`** - Scrape docs and generate config

```bash
mcpify parse https://docs.github.com/en/rest -o github.json --max-pages 15
```

| Option | Description |
|--------|-------------|
| `-o, --output` | Output file (default: `mcpify-config.json`) |
| `-m, --max-pages` | Max pages to scrape (default: 10) |
| `--no-follow` | Don't follow links |
| `-k, --api-key` | Gemini API key (or use env var) |
| `--model` | Gemini model (default: `gemini-2.0-flash`) |

**`mcpify serve <config>`** - Run MCP server

```bash
mcpify serve my-api.json --auth "Bearer token" --transport stdio
```

| Option | Description |
|--------|-------------|
| `-a, --auth` | Auth token for API calls |
| `-t, --transport` | `stdio`, `sse`, or `http` (default: `stdio`) |

**`mcpify show <config>`** - Print config as table

**`mcpify quickstart <url>`** - Parse and serve in one shot

## Config Format

The generated JSON looks like this:

```json
{
  "name": "my-api",
  "description": "Description of the API",
  "base_url": "https://api.example.com/v1",
  "version": "1.0.0",
  "auth": {
    "type": "bearer",
    "header_name": "Authorization",
    "prefix": "Bearer "
  },
  "tools": [
    {
      "name": "get_users",
      "description": "Retrieve a list of users",
      "method": "GET",
      "path": "/users",
      "parameters": [
        {
          "name": "limit",
          "type": "integer",
          "description": "Max results to return",
          "required": false,
          "location": "query",
          "default": 10
        }
      ],
      "response": {
        "description": "Array of user objects"
      },
      "tags": ["users"]
    }
  ]
}
```

Auth types: `none`, `api_key`, `bearer`, `oauth2`

Parameter locations: `query`, `path`, `header`, `body`

## Python API

```python
from mcpify.scraper import scrape_documentation
from mcpify.parser import parse_documentation
from mcpify.runtime import create_mcp_server

# Scrape docs
docs = await scrape_documentation("https://api.example.com/docs")

# Parse with Gemini
config = await parse_documentation(docs)

# Save config
config_path = "my-api.json"
with open(config_path, "w") as f:
    f.write(config.to_json())

# Create and run server
server = create_mcp_server(config, auth_token="your-token")
server.run()
```

## Examples

```bash
# GitHub
mcpify parse https://docs.github.com/en/rest/users -o github.json
mcpify serve github.json --auth "ghp_your_token"

# Stripe
mcpify parse https://stripe.com/docs/api -o stripe.json
mcpify serve stripe.json --auth "sk_test_your_key"
```

## License

MIT