Which integrations are available for this server?

Utilizes macOS as a compatible operating system for the fallback voice functionality. Requires Python 3.13+ for running the server.

How do I use Say MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Say MCP Server speak 'Task completed successfully' with speaker 2" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Say MCP Server

A Model Context Protocol (MCP) server that provides real-time voice notifications.

Features

Voice Notifications: Get instant audible updates on task progress and results.
High-Quality Voice: Utilizes a high-quality voice engine for clear and natural-sounding speech, especially for Japanese.
Automatic Fallback: Seamlessly switches to a standard system voice if the high-quality engine is unavailable, ensuring you never miss a notification.
Easy Integration: Designed for easy integration with AI agent environments that support the Model Context Protocol.

Related MCP server: MCP Node-Notifier Server

Installation

Clone the repository:
git clone <repository-url> cd say-mcp
Install dependencies:
uv sync
Test the installation:
uv run python test_server.py

Usage

With an AI Agent (MCP Integration)

Add this configuration to your agent's MCP settings:

{ "mcpServers": { "say-mcp": { "command": "uv", "args": ["run", "python", "-m", "say_mcp.server"], "cwd": "/absolute/path/to/say-mcp" } } }

Available Tools

The server provides the following tools for your AI agent:

speak: Notifies you by voice.
- Purpose: Converts text to speech for real-time, audible feedback.
- Example:
  { "text": "The analysis is complete and the report is ready.", "speaker": 1, "speed_scale": 1.2 }
- Parameters:
  - text (required): The message to be spoken.
  - speaker (optional): The desired speaker ID for the high-quality voice.
  - speed_scale (optional): Adjusts the speech speed for the high-quality voice.
check_voice_status: Checks the quality of the available voice.
- Purpose: Confirms whether the high-quality voice engine is active or if the system will use the standard fallback voice.

High-Quality Voice Setup (Optional)

For the best audio experience, you can install a compatible high-quality voice engine (e.g., VOICEVOX). The server will automatically detect and use it when it's running.