bouyomi-mcp-nodejs

🚀 棒読みちゃんMCPサーバー (Node.js版)

本项目是一个使用Model Context Protocol (MCP) 的服务器，它能为AI助手提供基于棒読みちゃん（ゆっくりボイス）的语音朗读功能。项目基于Node.js/TypeScript实现。

🚀 快速开始

前提条件

1. 安装Node.js版本16或以上。
2. 确保npm版本7或以上。
3. 棒読みちゃん已正确安装，并且其HTTP接口服务在50080端口上运行。

安装步骤

1. 克隆本仓库：

   git clone https://github.com/uraoz/bouyomichan-mcp-nodejs.git
   cd bouyomichan-mcp-nodejs
   

2. 安装依赖项：

   npm install
   

3. 编译代码：

   npm run build
   

启动说明

启动服务器：

npm start

与Claude for Desktop的集成

要将本服务器与Claude for Desktop连接，请按照以下步骤操作：

1. 打开Claude for Desktop的配置文件：
   • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. 在文件中添加如下内容（请将路径替换为实际服务器启动脚本的绝对路径）：

   {
     "mcpServers": {
       "bouyomi": {
         "command": "node",
         "args": [
           "/实际路径/bouyomichan-mcp-nodejs/build/index.js"
         ]
       }
     }
   }
   

3. 重启Claude for Desktop以使配置生效。

✨ 主要特性

• 文本朗读：实现文字转语音功能。
• 声音类型选择：可以选择不同的声音类型（如女性、男性等）。
• 音量调整：调节输出音量大小。
• 速度调节：控制朗读的速度。
• 音程调整：调节音调高低。

💻 使用示例

基础用法

在Claude for Desktop中，您可以按照以下方式使用：

• “こんにちは、世界”と読み上げて
• 男性の声で“これはテストです”と読み上げて
• 速度を速くして“急いでいます”と読み上げて

📚 详细文档

参数说明

| 属性 | 详情 | |------|------| | 参数名称 | 描述 | | text | 要朗读的文本，为必填项，支持任意文本 | | voice | 音声类型，默认值为0 (女性1)，可选值有0: 女性1，1: 男性1，2: 女性2 等 | | volume | 音量，默认值为 -1 (默认音量)，取值范围 -1: 默认音量，0 - 100: 可调节音量 | | speed | 速度，默认值为 -1 (默认速度)，取值范围 -1: 默认速度，50 - 200: 可调节速度 | | tone | 音调，默认值为 -1 (默认音调)，取值范围 -1: 默认音调，50 - 200: 可调节音调 |

📄 许可证

本项目采用MIT许可证。