内容
# Tonn MCP Server
MCP (Model Context Protocol) server for the [RoEx Tonn API](https://tonn.roexaudio.com) — AI-powered audio mixing, mastering, and analysis.
This server exposes Tonn's audio processing capabilities as MCP tools, enabling AI assistants like Claude to mix, master, and analyse audio directly in conversation.
## Tools
| Tool | Description | Credits |
|------|-------------|---------|
| `get_account_status` | View plan, credit balance, and recent tasks | Free |
| `get_upload_url` | Get a signed URL for uploading audio files | Free |
| `analyse_mix` | Analyse a mix or master for loudness, frequency balance, stereo width, and more | Charged |
| `master_track` | Master a track with configurable loudness and style (preview or final) | Preview free, final charged |
| `get_job_status` | Check the status of a long-running processing job | Free |
## Authentication
This server uses OAuth 2.0 with the Tonn Portal as the Authorization Server. Users authenticate through their existing Tonn account — no API key pasting required.
The server implements RFC 9728 (Protected Resource Metadata) for automatic AS discovery.
## Deployment
### Cloud Run
```bash
gcloud run deploy tonn-mcp \
--source . \
--region europe-west1 \
--allow-unauthenticated \
--set-env-vars "TONN_MCP_PORTAL_URL=https://tonn-portal.roexaudio.com,TONN_MCP_API_URL=https://tonn.roexaudio.com,TONN_MCP_SERVER_URL=https://mcp.roexaudio.com"
```
### Local development
```bash
pip install -e .
TONN_MCP_PORTAL_URL=http://localhost:5000 TONN_MCP_API_URL=https://tonn.roexaudio.com TONN_MCP_SERVER_URL=http://localhost:8080 uvicorn tonn_mcp.server:app --port 8080 --reload
```
## License
MIT
MCP 市场