Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client