Bouyomi-chan MCP Server

by uraoz

Boyomi-chan MCP Server (Node.js version)

This is a server that uses the Model Context Protocol (MCP) to provide text-to-speech functionality using Bokuyomi-chan (a slow voice) to AI assistants. It is implemented in Node.js/TypeScript.

overview

This server is an MCP server that allows AI assistants such as Claude to use Boyomi-chan.

function

  • Text to speech
  • Select voice type (female, male, etc.)
  • Volume adjustment
  • Adjustable speech speed
  • Pitch Adjustment

Prerequisites

  • Node.js 16 or higher
  • npm 7 or higher
  • Boyomi-chan must be installed.
  • The HTTP link for Boyomi-chan is running on port 50080.

How to install

  1. Clone this repository:
git clone https://github.com/uraoz/bouyomichan-mcp-nodejs.git cd bouyomichan-mcp-nodejs
  1. Install the dependencies:
npm install
  1. Which compiles:
npm run build

How to use

Starting the Server

npm start

Integration with Claude for Desktop

To work with Claude for Desktop you need to edit the configuration file:

  1. Open the Claude for Desktop configuration file:
    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the following content (replace the paths with the actual file paths):
{ "mcpServers": { "bouyomi": { "command": "node", "args": [ "/絶対パス/bouyomichan-mcp-nodejs/build/index.js" ] } } }
  1. Restart Claude for Desktop.

Usage Example

Claude for Desktop will read text aloud to you by:

  • Read out "Hello, World"
  • A male voice reads out "This is a test."
  • Speed up and read "I'm in a hurry"

Parameter Description

ParametersexplanationDefault valueScope
textRead textRequiredAny text
voiceAudio Type0 (1 female)0: Female 1, 1: Male 1, 2: Female 2, ...
volumevolume-1 (default)-1: default, 0-100: volume level
speedspeed-1 (default)-1: default, 50-200: speed level
tonePitch-1 (default)-1: default, 50-200: pitch level

license

MIT

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Node.js server that enables AI assistants to interact with Bouyomi-chan's text-to-speech functionality through Model Context Protocol (MCP), allowing for voice reading of text with adjustable parameters.

  1. overview
    1. function
      1. Prerequisites
        1. How to install
          1. How to use
            1. Starting the Server
            2. Integration with Claude for Desktop
          2. Usage Example
            1. Parameter Description
              1. license

                Related MCP Servers

                • -
                  security
                  A
                  license
                  -
                  quality
                  A TypeScript-based MCP server that provides two tools for chatting with Mistral AI models, supporting both text-only conversations and image+text inputs.
                  Last updated -
                  JavaScript
                  MIT License
                  • Apple
                • -
                  security
                  F
                  license
                  -
                  quality
                  A Node.js server that implements Model Context Protocol (MCP) for controlling HWP (Korean word processor) documents, allowing AI assistants like Claude to create and manipulate Hangul documents.
                  Last updated -
                  27
                  Python
                • -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol (MCP) server that allows AI agents like Claude to interact with the Aligo SMS API to send text messages and retrieve related information.
                  Last updated -
                  JavaScript
                  MIT License
                • A
                  security
                  A
                  license
                  A
                  quality
                  An official Model Context Protocol (MCP) server that enables AI clients to interact with ElevenLabs' Text to Speech and audio processing APIs, allowing for speech generation, voice cloning, audio transcription, and other audio-related tasks.
                  Last updated -
                  19
                  633
                  Python
                  MIT License
                  • Apple

                View all related MCP servers

                ID: gt1ul6tikz