# aipatterns.com.au MCP Server

A Model Context Protocol (MCP) server that exposes the [aipatterns.com.au](https://aipatterns.com.au) pattern library, AU AI incidents, sector benchmarks, and regulatory changes as tools callable by Claude, Cursor, GitHub Copilot, and other MCP-compatible AI assistants.

## What it provides

| Tool | Description |
|------|-------------|
| `search_patterns` | Full-text search across the pattern library (title, description, content) |
| `get_pattern` | Retrieve full detail + implementation guidance for a specific pattern |
| `get_incidents` | Notable Australian AI incidents with linked patterns and regulatory outcomes |
| `get_sector_benchmark` | AU AI Maturity Index scores for banking, insurance, government, retail, healthcare, utilities |
| `get_regulatory_changes` | APRA CPS 230, OAIC Privacy Act reform, ASIC INFO 183, TGA SaMD, and more |

No database connection or network calls are required at runtime — all data is served from the local pattern files and hardcoded seed data.

Published on npm as [`aipatterns-mcp-server`](https://www.npmjs.com/package/aipatterns-mcp-server) — no clone or build step needed, `npx` fetches and runs it.

## Add to Claude Desktop

Edit `~/.config/claude/claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "aipatterns": {
      "command": "npx",
      "args": ["-y", "aipatterns-mcp-server"]
    }
  }
}
```

Restart Claude Desktop.

## Add to Cursor

Create or edit `.cursor/mcp.json` in your project root:

```json
{
  "mcpServers": {
    "aipatterns": {
      "command": "npx",
      "args": ["-y", "aipatterns-mcp-server"]
    }
  }
}
```

## Add to GitHub Copilot (VS Code MCP extension)

Add to your VS Code `settings.json`:

```json
{
  "mcp.servers": {
    "aipatterns": {
      "command": "npx",
      "args": ["-y", "aipatterns-mcp-server"],
      "transport": "stdio"
    }
  }
}
```

## Running from source (development)

```bash
git clone https://github.com/uchit/aipatterns-mcp-server
cd aipatterns-mcp-server
npm install
npm run dev    # runs via tsx (no build step needed)
npm run build  # compile TS → JS for production use
```

## Transport

stdio — the server reads JSON-RPC from stdin and writes responses to stdout. stderr is used for diagnostic messages only.