volcengine-api-mcp 0.0.0-stage → 0.1.0

package/dist/tools/tts.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { mkdirSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { TTS_DEFAULT_RESOURCE_ID, TTS_DEFAULT_SAMPLE_RATE, TTS_DEFAULT_SPEAKER, unidirectionalTts, } from '../lib/index.js';
+const AUDIO_MIME = {
+    mp3: 'audio/mpeg',
+    pcm: 'audio/pcm',
+    ogg_opus: 'audio/ogg',
+    wav: 'audio/wav',
+};
+function resolveArkApiKey() {
+    const key = process.env.ARK_API_KEY;
+    if (!key?.trim() || !/^ark-[A-Za-z0-9-]+$/.test(key.trim())) {
+        throw new Error('缺少有效的方舟 API Key(ark- 开头)，请配置环境变量 ARK_API_KEY');
+    }
+    return key.trim();
+}
+export const ttsUnidirectionalTool = {
+    name: 'plan_tts_unidirectional',
+    description: '火山豆包语音合成大模型-单向流式（端点 /api/v3/plan/tts/unidirectional，HTTP Chunked）。输入文本一次性合成音频，落盘并返回给 Agent。' +
+        '默认音色 zh_female_vv_uranus_bigtts（豆包 2.0 通用女声），音色 ID 从控制台>音色库获取；复刻音色需 resource_id=seed-icl-2.0 并传 model。' +
+        '需要环境变量 ARK_API_KEY。',
+    inputSchema: {
+        text: z.string().min(1).describe('待合成的文本'),
+        output_path: z.string().min(1).describe('音频保存的绝对路径（扩展名与 format 一致，如 .mp3/.wav/.ogg/.pcm）'),
+        speaker: z.string().optional().describe(`音色 ID，默认 ${TTS_DEFAULT_SPEAKER}`),
+        resource_id: z.string().optional().describe(`模型版本资源，默认 ${TTS_DEFAULT_RESOURCE_ID}；声音复刻用 seed-icl-2.0`),
+        model: z.string().optional().describe('复刻音色时需指定，如 seed-tts-2.0-standard'),
+        format: z.enum(['mp3', 'pcm', 'ogg_opus', 'wav']).optional().describe('音频格式，默认 mp3'),
+        sample_rate: z.number().int().optional().describe(`采样率 Hz，默认 ${TTS_DEFAULT_SAMPLE_RATE}；ogg_opus 仅支持 48000`),
+        speech_rate: z.number().int().min(-50).max(100).optional().describe('语速 [-50,100]，100 = 2.0 倍速'),
+        loudness_rate: z.number().int().min(-50).max(100).optional().describe('音量 [-50,100]，100 = 2.0 倍音量'),
+        enable_subtitle: z.boolean().optional().describe('启用字幕（字级时间戳），仅中英文'),
+        explicit_language: z.string().optional().describe('显式朗读语种，如 zh-cn / en / ja，不传自动检测'),
+    },
+    handler: async (args) => {
+        const result = await unidirectionalTts({
+            apiKey: resolveArkApiKey(),
+            text: args.text,
+            speaker: args.speaker,
+            resourceId: args.resource_id,
+            model: args.model,
+            format: args.format,
+            sampleRate: args.sample_rate,
+            speechRate: args.speech_rate,
+            loudnessRate: args.loudness_rate,
+            enableSubtitle: args.enable_subtitle,
+            explicitLanguage: args.explicit_language,
+        });
+        const path = resolve(args.output_path);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, result.audio);
+        const bytes = statSync(path).size;
+        if (bytes < 1024) {
+            throw new Error(`落盘文件过小(${bytes}B),疑似异常响应`);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        ok: true,
+                        output: path,
+                        format: result.format,
+                        sample_rate: result.sampleRate,
+                        bytes,
+                        text_words: result.usage?.text_words,
+                        sentence: result.sentence?.text,
+                    }, null, 2),
+                },
+                {
+                    type: 'audio',
+                    data: result.audio.toString('base64'),
+                    mimeType: AUDIO_MIME[result.format] ?? 'audio/mpeg',
+                },
+            ],
+        };
+    },
+};
+//# sourceMappingURL=tts.js.map

package/dist/tools/tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.js","sourceRoot":"","sources":["../../src/tools/tts.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "volcengine-api-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "火山引擎 API 的 MCP Server（stdio）：方舟生图 / TTS / TOS 上传 / 语音转写 / 联网搜索",
+  "license": "MIT",
+  "author": "Marvin Pan",
+  "keywords": [
+    "volcengine",
+    "mcp",
+    "ark",
+    "seedream",
+    "doubao",
+    "tos",
+    "asr",
+    "tts",
+    "search",
+    "model-context-protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/panmenglin/volcengine-api-mcp.git"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "volcengine-api-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "@volcengine/tos-sdk": "^2.9.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js"
+  }
 }