scc-mcp

A stdio MCP server that bridges the Scarborough Community Choir API into any MCP client (Claude Desktop, etc.).

Everything the AI can do is defined server-side in the API's /ai/manifest endpoint and only handed to a valid API key. This package ships no knowledge of the API surface itself — it's a generic manifest→REST bridge.

1. Get an API key

Sign in to the admin, open the AI Access page, and generate a key. Choose a read-only or read/write scope as appropriate. Copy the key — it's shown once.

2. Install into Claude Desktop

The interactive installer locates Claude Desktop's config, asks for the API URL and your key, and merges in an scc server (keeping any servers you already have):

npx scc-mcp install

Then fully quit and reopen Claude Desktop. The choir tools appear once it reconnects.

Manual setup

Alternatively, edit Claude Desktop's config yourself:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add an scc entry under mcpServers (create the file/object if missing):

{
  "mcpServers": {
    "scc": {
      "command": "npx",
      "args": ["-y", "scc-mcp"],
      "env": {
        "SCC_API_URL": "http://localhost:3200",
        "SCC_API_KEY": "your-key-here"
      }
    }
  }
}

Restart Claude Desktop after saving.

Configuration

| Variable | Default | Description | | ------------- | ----------------------- | ------------------------------------ | | SCC_API_KEY | (required) | Key from the admin AI Access page. | | SCC_API_URL | http://localhost:3200 | Base URL of the choir API. |

Running the server with SCC_API_KEY unset prints a help message and exits non-zero.

Bin

• scc-mcp — the MCP server (run over stdio by the client). Run scc-mcp install to launch the interactive Claude Desktop installer instead.