# AISIX AI Gateway MCP server

> Provides a single OpenAI-compatible API to route, govern, secure, and observe traffic across multiple LLM providers and MCP servers.

- Repository: https://github.com/api7/aisix
- Page: https://hostedmcp.org/servers/api7/aisix
- Transport: remote
- Stars: 219
- License: Apache-2.0
- Latest version: 1.3.0

## Install

### Claude Code

```sh
claude mcp add aisix -- docker run -i --rm ghcr.io/api7/aisix:1.3.0
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "aisix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/api7/aisix:1.3.0"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "aisix": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/api7/aisix:1.3.0"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "aisix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/api7/aisix:1.3.0"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.aisix]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/api7/aisix:1.3.0"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "aisix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/api7/aisix:1.3.0"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CALLER_API_KEY` | no | no |  |
| `OPENAI_API_KEY` | no | no |  |

## FAQ

### How do I apply configuration changes without restarting the gateway?

You can reload the configuration atomically by sending a SIGHUP signal to the process after editing your resources.yaml file.

### Does AISIX support MCP servers?

Yes, it acts as an MCP gateway that fronts registered upstream MCP servers with per-server tool namespaces and per-caller access.

### Can I use AISIX with Anthropic models using the OpenAI format?

Yes, the gateway translates OpenAI or Anthropic wire formats, allowing you to point an OpenAI SDK at the gateway to access different providers.

### What kind of security and guardrails are included?

It includes content-policy enforcement, PII detection and redaction, and integration with providers like OpenAI Moderation and AWS Bedrock Guardrails.