Rime MCP

by MatthewDailey

27 stars
199 downloads
Not rated
GitHub

About

Rime MCP is a Model Context Protocol (MCP) server that provides text-to-speech capabilities using the Rime API. It downloads synthesized audio and plays it through the system’s native audio player, intended for use with AI agents.

Details

Author
MatthewDailey
GitHub stars
27
Downloads
199
Categories
Other

- Exposes a speak tool for text-to-speech
- Uses Rime’s high-quality voice synthesis API
- Plays audio through the system’s native player
- Supports customization via environment variables
- Works out of the box on macOS (uses afplay)
- Open source under the MIT license

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Rime MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure it as an MCP tool by adding an entry to your MCP client’s settings with npx rime-mcp and setting the RIME_API_KEY environment variable. Optional environment variables can customize the voice, guidance, and when to speak. The server exposes a speak tool that converts text to speech and plays it.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "rime mcp": {
            "rime-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@MatthewDailey/rime-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "rime-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@MatthewDailey/rime-mcp",
            "--client",
            "claude"
        ]
    }
}

Rime MCP

rime

A Model Context Protocol (MCP) server that provides text-to-speech capabilities using the Rime API. This server downloads audio and plays it using the system's native audio player.

Features

- Exposes a speak tool that converts text to speech and plays it through system audio
- Uses Rime's high-quality voice synthesis API

Requirements

- Node.js 16.x or higher
- A working audio output device
- macOS: Uses afplay

There's sample code from Claude for the following that is not tested 🤙✨
- Windows: Built-in Media.SoundPlayer (PowerShell)
- Linux: mpg123, mplayer, aplay, or ffplay

MCP Configuration

"ref": {
  "command": "npx",
  "args": ["rime-mcp"],
  "env": {
      RIME_API_KEY=your_api_key_here

# Optional configuration
RIME_GUIDANCE="<guide how the agent speaks>"
RIME_WHO_TO_ADDRESS="<your name>"
RIME_WHEN_TO_SPEAK="<tell the agent when to speak>"
RIME_VOICE="cove"
}
}

All of the optional env vars are part of the tool definition and are prompts to

All voice options are listed here.

You can get your API key from the Rime Dashboard.

The following environment variables can be used to customize the behavior:

- RIME_GUIDANCE: The main description of when and how to use the speak tool
- RIME_WHO_TO_ADDRESS: Who the speech should address (default: "user")
- RIME_WHEN_TO_SPEAK: When the tool should be used (default: "when asked to speak or when finishing a command")
- RIME_VOICE: The default voice to use (default: "cove")

Example use cases

Demo of Rime MCP in Cursor

Example 1: Coding agent announcements

"RIME_WHEN_TO_SPEAK": "Always conclude your answers by speaking.",
"RIME_GUIDANCE": "Give a brief overview of the answer. If any files were edited, list them."

Example 2: Learn how the kids talk these days

RIME_GUIDANCE="Use phrases and slang common among Gen Alpha."
RIME_WHO_TO_ADDRESS="Matt"
RIME_WHEN_TO_SPEAK="when asked to speak"

Example 3: Different languages based on context

RIME_VOICE="use 'cove' when talking about Typescript and 'antoine' when talking about Python"

Development

1. Install dependencies:

npm install

2. Build the server:

npm run build

3. Run in development mode with hot reload:

npm run dev

License

MIT

Badges

<a href="https://glama.ai/mcp/servers/@MatthewDailey/rime-mcp">
Rime MCP server
</a>
<a href="https://smithery.ai/server/@MatthewDailey/rime-mcp">Smithery Badge</a>

Installing via Smithery

To install Rime Text-to-Speech Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @MatthewDailey/rime-mcp --client claude
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.