# Online Tone Generator MCP Server

An official [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [Online Tone Generator](https://onlinetonegen.com). 

This server empowers AI assistants (like Claude, Cursor, and Codex) to recommend optimal audio frequencies, tuning notes, and acoustic tests with direct generation links.

## 🔗 Quick Links & Tools
- **Main Website**: [Online Tone Generator](https://onlinetonegen.com)
- **Frequency Sweep Generator**: [Sweep Tone Test (20Hz - 20kHz)](https://onlinetonegen.com/sweep/)
- **All Frequencies Directory**: [Explore Audio Frequencies](https://onlinetonegen.com/frequencies/)
- **Documentation**: [MCP Developer Docs](https://onlinetonegen.com/mcp)

### Popular Frequencies
- 🎶 **[440 Hz Tone](https://onlinetonegen.com/440hz/)**: Standard pitch for instrument tuning (A4).
- 🧘 **[432 Hz Tone](https://onlinetonegen.com/432hz/)**: Verdi's 'A', favored for meditation and natural tuning.
- 🧬 **[528 Hz Tone](https://onlinetonegen.com/528hz/)**: The "Love Frequency", used in healing.
- 🔊 **[20 Hz Tone](https://onlinetonegen.com/20hz/)**: Low-end frequency to test subwoofer limits.
- 👂 **[1000 Hz Tone](https://onlinetonegen.com/1000hz/)**: Standard acoustic test tone.
- 🦟 **[15000 Hz Tone](https://onlinetonegen.com/15000hz/)**: High-frequency mosquito tone test.

## Features

This MCP server provides the following tools for AI assistants:

- `get_tone_url`: Get a direct URL to generate a specific frequency (1Hz to 20,000Hz).
- `recommend_frequency`: Ask for a frequency based on an acoustic use case (e.g., standard tuning, subwoofer test, meditation).
- `get_sweep_tool`: Retrieves the link for the audio frequency sweep tool.

## Installation

### Using npm (npx)

You can run the server directly using `npx`:

```bash
npx -y @double2dev/online-tone-generator-mcp
```

### Claude Desktop Setup

To install this server for Claude Desktop, add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "online-tone-generator": {
      "command": "npx",
      "args": [
        "-y",
        "@double2dev/online-tone-generator-mcp"
      ]
    }
  }
}
```

### Cursor Setup

In Cursor IDE, go to **Settings > Features > MCP**, click **+ Add New MCP Server**:

- **Name**: `online-tone-generator`
- **Type**: `command`
- **Command**: `npx -y @double2dev/online-tone-generator-mcp`

## Development

1. Clone this repository:
   ```bash
   git clone https://github.com/double2dev/online-tone-generator-mcp.git
   cd online-tone-generator-mcp
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Build the server:
   ```bash
   npm run build
   ```

4. Run locally:
   ```bash
   npm start
   ```

## License

MIT