返回 MCP 目录
public公开dns本地运行

bouyomichan-mcp-nodejs

这是一个基于Node.js的MCP服务器项目,通过Model Context Protocol实现AI助手与棒読みちゃん语音合成软件的集成,提供文本转语音功能。

article

README

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

这是一个使用Model Context Protocol (MCP) 为AI助手提供棒読みちゃん(缓慢语音)语音朗读功能的服务器,采用Node.js/TypeScript实现。

🚀 快速开始

本服务器是一个MCP服务器,可让Claude等AI助手使用棒読みちゃん。

✨ 主要特性

  • 文本朗读
  • 语音类型选择(女性、男性等)
  • 音量调节
  • 朗读速度调节
  • 音程调节

📦 安装指南

前提条件

  • Node.js 16及以上版本
  • npm 7及以上版本
  • 已安装棒読みちゃん
  • 棒読みちゃん的HTTP连接已在端口50080启动

安装步骤

  1. 克隆此仓库:
git clone https://github.com/uraoz/bouyomichan-mcp-nodejs.git
cd bouyomichan-mcp-nodejs
  1. 安装依赖项:
npm install
  1. 进行编译:
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"
      ]
    }
  }
}
  1. 重启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许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端