# AI Service Gateway MCP

> **The AI uses services, not secrets.**

A fundamentally new approach to providing AI agents access to authenticated services.
Instead of giving the AI a password manager or storing tokens in its context window, this MCP server acts as an opaque **Service Gateway**.

## The Concept

The AI never knows that tokens, passwords, or SSH keys exist. It is only given a list of *services* and what they can do. 
When the AI wants to fetch data from GitHub, it asks the Gateway to make an HTTP call to the "github" service. The Gateway injects the authentication server-side.

This completely eliminates the risk of prompt injection extracting tokens, or tokens being leaked in conversation histories and inference server logs.

## Features

- **No Secrets in Context**: The AI only sees service names (`github`, `nas_ssh`, `email`) and their capabilities.
- **Config-Driven**: Define your services and authentication methods in a single `gateway.yaml` file.
- **Environment Variables**: Inject actual secret values using environment variables so they aren't hardcoded in the config.
- **Supported Protocols**:
  - `http` (Bearer, Basic, Custom Headers, Query Params)
  - `ssh` (Password, Private Key) with allowed command patterns
  - `smtp` (Email sending)
- **Output Sanitizer**: Automatically scrubs all known secret values from tool outputs as a defense-in-depth measure.

## Quick Start

### 1. Create a Configuration

Create a `gateway.yaml` file:

```yaml
services:
  github:
    type: http
    base_url: https://api.github.com
    auth:
      type: bearer
      token: ${GITHUB_TOKEN}
    capabilities: [repos, issues]
```

### 2. Run the Gateway

```bash
export GITHUB_TOKEN="ghp_supersecret..."
python -m ai_gateway check --config gateway.yaml
python -m ai_gateway serve --config gateway.yaml --port 8600
```

Or using Docker:

```bash
docker compose up -d
```

### 3. Connect your AI Agent

Configure your MCP client (like OpenCode or Claude Desktop) to connect to `http://localhost:8600/sse`.

## MCP Tools Provided

1. `service_list()`: Returns the public manifest of configured services and capabilities.
2. `service_call(service, method, path, ...)`: Makes an authenticated HTTP request.
3. `service_ssh(service, command)`: Runs a command over SSH (if allowed by config).
4. `service_email(service, to, subject, body)`: Sends an email via SMTP.

## License
MIT