botnoi-voice-mcp 1.0.0

package/README.md

@@ -0,0 +1,71 @@
+# Botnoi Voice MCP 🇹🇭🗣️
+
+A **Model Context Protocol (MCP)** server for Text-to-Speech generation (Thai, English, and other regional languages) via the **Botnoi Voice API**. Designed to empower AI assistants (e.g., Claude 3.5 Sonnet, Cursor) to seamlessly synthesize speech and discover available voices dynamically.
+
+## 🌟 Features
+- 🎙️ **Generate Speech** (`generate_speech`): Allows the AI to convert text immediately to audio and download it as an `.mp3` file.
+- 🔍 **List & Filter Voices** (`list_voices`): Smartly search and filter through the Botnoi Voice library. Examples: search for "Thai female teen voice" or "Male news anchor voice".
+
+---
+
+## 🚀 Installation
+
+You can use the server directly via `npx` (no installation required) or install it globally:
+
+```bash
+# Global installation
+npm install -g botnoi-voice-mcp
+```
+
+---
+
+## 🔑 Configuration
+
+A Botnoi Voice API Key is required. You can register and obtain one from the [Botnoi Voice Dashboard](https://voice.botnoi.ai/).  
+Set your API key as an environment variable named `BOTNOI_API_KEY`.
+
+### Example Configuration for Claude Desktop
+
+Add the server to your Claude Desktop configuration file (e.g., on Windows: `%APPDATA%\Claude\claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "botnoi-voice": {
+      "command": "npx",
+      "args": ["-y", "botnoi-voice-mcp"],
+      "env": {
+        "BOTNOI_API_KEY": "YOUR_API_KEY_HERE"
+      }
+    }
+  }
+}
+```
+
+---
+
+## 🛠️ Available Tools
+
+### `list_voices`
+Discover and search the available voice models inside the Botnoi Voice library.
+- `language` (optional): Filter by language (e.g., `'th'`, `'en'`, `'ja'`).
+- `gender` (optional): Filter by gender (e.g., `'Female'`, `'Male'`).
+- `age_style` (optional): Filter by age group (e.g., `'วัยเด็ก'` (Child), `'วัยรุ่น'` (Teen), `'วัยผู้ใหญ่'` (Adult)).
+
+### `generate_speech`
+Convert specified text into a speech output.
+- `text` (required): The text to be synthesized into speech.
+- `speaker` (optional): The Voice ID (e.g., `"1"`). Defaults to a basic voice.
+- `language` (optional): Language code (e.g., `"th"`).
+- `speed` (optional): Speech speed ranging from 0.5 to 2.0.
+
+---
+
+## ⚠️ Important Note for Developers
+
+> If you are a developer extending this MCP, note that `list_voices` currently reads directly from a static local JSON response file. **If you publish this to NPM**, please ensure the `.json` file is correctly bundled in your build output (`dist/`) and referenced via `__dirname`, or fallback to making a live HTTP `fetch` to ensure it works across all user environments!
+
+---
+
+## 📝 License
+MIT

package/dist/index.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import fs from "fs";
+import path from "path";
+const API_KEY = process.env.BOTNOI_API_KEY || "";
+const BASE_URL = "https://api-voice.botnoi.ai/openapi/v1";
+// ===== สร้าง Server =====
+const server = new Server({ name: "botnoi-voice-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
+// ===== กำหนด Tools =====
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "generate_speech",
+            description: "แปลงข้อความเป็นเสียงพูดด้วย Botnoi Voice API รองรับภาษาไทย, อังกฤษ และภาษาอาเซียน",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    text: {
+                        type: "string",
+                        description: "ข้อความที่ต้องการแปลงเป็นเสียง",
+                    },
+                    speaker: {
+                        type: "string",
+                        description: "ID ของเสียงที่ต้องการ (เช่น '1' สำหรับ Eva)",
+                        default: "1",
+                    },
+                    language: {
+                        type: "string",
+                        description: "ภาษา เช่น 'th' (ไทย), 'en' (อังกฤษ)",
+                        default: "th",
+                    },
+                    speed: {
+                        type: "number",
+                        description: "ความเร็วในการพูด (0.5 - 2.0)",
+                        default: 1,
+                    },
+                    output_path: {
+                        type: "string",
+                        description: "path สำหรับบันทึกไฟล์ MP3 (optional)",
+                    },
+                },
+                required: ["text"],
+            },
+        },
+        {
+            name: "list_voices",
+            description: "ค้นหาและดูรายการเสียงที่มีใน Botnoi Voice (เช่น หาเสียงผู้หญิง, เสียงเด็ก, เสียงภาษาไทย)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    language: {
+                        type: "string",
+                        description: "กรองตามภาษา เช่น 'th', 'en'",
+                    },
+                    gender: {
+                        type: "string",
+                        description: "กรองตามเพศ เช่น 'ผู้หญิง', 'ผู้ชาย', 'Female', 'Male'",
+                    },
+                    age_style: {
+                        type: "string",
+                        description: "กรองตามช่วงวัย เช่น 'วัยเด็ก', 'วัยรุ่น', 'วัยผู้ใหญ่'",
+                    }
+                },
+            },
+        },
+    ],
+}));
+// ===== Tool Handlers =====
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    if (!API_KEY) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "❌ กรุณาตั้งค่า BOTNOI_API_KEY environment variable",
+                },
+            ],
+        };
+    }
+    if (name === "generate_speech") {
+        const { text, speaker = "1", language = "th", speed = 1, output_path } = args;
+        try {
+            const response = await fetch(`${BASE_URL}/generate_audio`, {
+                method: "POST",
+                headers: {
+                    "accept": "application/json",
+                    "Content-Type": "application/json",
+                    "botnoi-token": API_KEY,
+                },
+                body: JSON.stringify({
+                    text,
+                    speaker,
+                    language,
+                    speed,
+                    volume: 1,
+                    type_media: "mp3",
+                    save_file: "true",
+                    page: "user",
+                }),
+            });
+            if (!response.ok) {
+                const err = await response.text();
+                throw new Error(`API Error ${response.status}: ${err}`);
+            }
+            const data = await response.json();
+            const audioUrl = data.audio_url || data.url;
+            // ถ้ามี output_path ให้ download ไฟล์มาเก็บ
+            if (output_path && audioUrl) {
+                const audioRes = await fetch(audioUrl);
+                const buffer = await audioRes.arrayBuffer();
+                fs.writeFileSync(output_path, Buffer.from(buffer));
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `✅ สร้างเสียงสำเร็จ!\n📁 บันทึกที่: ${path.resolve(output_path)}\n🔗 URL: ${audioUrl}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ สร้างเสียงสำเร็จ!\n🔗 URL: ${audioUrl}\n\nสามารถเล่นหรือดาวน์โหลดได้จาก URL ด้านบน`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ เกิดข้อผิดพลาด: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    if (name === "list_voices") {
+        try {
+            const { language, gender, age_style } = args || {};
+            const filePath = path.resolve(process.cwd(), "response_1775701990226.json");
+            let data;
+            try {
+                const fileContent = fs.readFileSync(filePath, "utf-8");
+                data = JSON.parse(fileContent);
+            }
+            catch (err) {
+                throw new Error(`ไม่สามารถอ่านไฟล์ JSON ได้: ${err.message}`);
+            }
+            if (language) {
+                const langLower = String(language).toLowerCase();
+                data = data.filter((v) => v.language?.toLowerCase() === langLower || v.available_language?.includes(langLower));
+            }
+            if (gender) {
+                const genderLower = String(gender).toLowerCase();
+                data = data.filter((v) => v.gender === gender || v.eng_gender?.toLowerCase() === genderLower);
+            }
+            if (age_style) {
+                data = data.filter((v) => v.age_style === age_style || v.eng_age_style?.toLowerCase() === String(age_style).toLowerCase());
+            }
+            const conciseData = data.map((v) => ({
+                speaker_id: v.speaker_id,
+                name: v.thai_name || v.eng_name,
+                gender: v.gender,
+                age: v.age_style,
+                style: v.voice_style?.join(", ") || "",
+                speed: v.speed
+            }));
+            return {
+                content: [{ type: "text", text: JSON.stringify(conciseData, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `❌ ${error.message}` },
+                ],
+                isError: true,
+            };
+        }
+    }
+    return {
+        content: [{ type: "text", text: `Tool "${name}" ไม่พบ` }],
+        isError: true,
+    };
+});
+// ===== Start Server =====
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("Botnoi Voice MCP Server running...");