volcengine-api-mcp 0.0.0-stage → 0.1.0

package/dist/lib/tts.js

@@ -0,0 +1,126 @@
+/**
+ * 豆包语音合成大模型 - 单向流式 HTTP 接口（HTTP Chunked）。
+ * 文档: https://www.volcengine.com/docs/6561/1327536 （单向流式语音合成 HTTP）
+ * - Agent Plan 网关: POST https://openspeech.bytedance.com/api/v3/plan/tts/unidirectional（ark- 密钥）
+ * - 语音控制台:     POST https://openspeech.bytedance.com/api/v3/tts/unidirectional（X-Api-Key）
+ * 响应为流式 JSON 分片，每片 {code, message, data: base64音频, sentence?, usage?}，拼接 data 直到流结束。
+ */
+const PLAN_TTS_URL = 'https://openspeech.bytedance.com/api/v3/plan/tts/unidirectional';
+/** 语音控制台密钥使用的官方端点（Agent Plan 之外的接入方式，暂未暴露为工具参数） */
+export const CONSOLE_TTS_URL = 'https://openspeech.bytedance.com/api/v3/tts/unidirectional';
+export const TTS_DEFAULT_SPEAKER = 'zh_female_vv_uranus_bigtts'; // 豆包 2.0 通用女声
+export const TTS_DEFAULT_RESOURCE_ID = 'seed-tts-2.0';
+export const TTS_DEFAULT_SAMPLE_RATE = 24_000;
+/** 从流式 buffer 中提取顶层 JSON 对象（兼容换行分隔与直接拼接两种分片方式） */
+export function extractJsonObjects(buffer) {
+    const objects = [];
+    let depth = 0;
+    let start = -1;
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < buffer.length; i++) {
+        const ch = buffer[i];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (ch === '\\')
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"')
+            inString = true;
+        else if (ch === '{') {
+            if (depth === 0)
+                start = i;
+            depth++;
+        }
+        else if (ch === '}') {
+            depth--;
+            if (depth === 0 && start >= 0) {
+                objects.push(JSON.parse(buffer.slice(start, i + 1)));
+                start = -1;
+            }
+        }
+    }
+    // 字符串未闭合/对象未闭合的部分留给下一次
+    const rest = depth > 0 || inString ? buffer.slice(Math.max(start, 0)) : buffer.slice(buffer.length);
+    return { objects, rest };
+}
+/** 提交单向流式合成并收集完整音频。 */
+export async function unidirectionalTts(opts) {
+    if (!opts.apiKey?.trim()) {
+        throw new Error('缺少 API Key，请配置环境变量 ARK_API_KEY');
+    }
+    if (!opts.text?.trim()) {
+        throw new Error('缺少待合成文本 text');
+    }
+    const format = opts.format ?? 'mp3';
+    const sampleRate = opts.sampleRate ?? TTS_DEFAULT_SAMPLE_RATE;
+    const endpoint = opts.endpoint ?? PLAN_TTS_URL;
+    const reqParams = {
+        text: opts.text,
+        speaker: opts.speaker ?? TTS_DEFAULT_SPEAKER,
+        audio_params: {
+            format,
+            sample_rate: sampleRate,
+            ...(opts.speechRate !== undefined ? { speech_rate: opts.speechRate } : {}),
+            ...(opts.loudnessRate !== undefined ? { loudness_rate: opts.loudnessRate } : {}),
+        },
+        ...(opts.model !== undefined ? { model: opts.model } : {}),
+        ...(opts.enableSubtitle !== undefined ? { enable_subtitle: opts.enableSubtitle } : {}),
+        ...(opts.explicitLanguage !== undefined ? { explicit_language: opts.explicitLanguage } : {}),
+    };
+    const res = await fetch(endpoint, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Connection: 'keep-alive',
+            'X-Api-Key': opts.apiKey.trim(),
+            'X-Api-Resource-Id': opts.resourceId ?? TTS_DEFAULT_RESOURCE_ID,
+            'X-Api-Request-Id': crypto.randomUUID(),
+        },
+        body: JSON.stringify({ req_params: reqParams }),
+        signal: AbortSignal.timeout(opts.timeoutMs ?? 300_000),
+    });
+    if (!res.ok || !res.body) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`TTS 接口返回 ${res.status}:${text.slice(0, 300) || res.statusText}`);
+    }
+    const chunks = [];
+    let total = 0;
+    let sentence;
+    let usage;
+    let pending = '';
+    const decoder = new TextDecoder();
+    for await (const chunk of res.body) {
+        pending += decoder.decode(chunk, { stream: true });
+        const { objects, rest } = extractJsonObjects(pending);
+        pending = rest;
+        for (const obj of objects) {
+            const msg = obj;
+            // 成功码：0 或 20000000（openspeech 通用成功状态，与语音识别一致；实测 plan 网关返回后者）
+            if (typeof msg.code === 'number' && msg.code !== 0 && msg.code !== 20_000_000) {
+                throw new Error(`TTS 合成失败：code=${msg.code}，message=${msg.message ?? '无'}`);
+            }
+            if (msg.sentence?.text)
+                sentence = msg.sentence;
+            if (msg.usage)
+                usage = msg.usage;
+            if (msg.data) {
+                const audio = Buffer.from(msg.data, 'base64');
+                chunks.push(audio);
+                total += audio.length;
+            }
+        }
+    }
+    if (pending.trim()) {
+        throw new Error(`TTS 响应存在未完成的 JSON 分片，疑似响应中断：${pending.slice(0, 120)}`);
+    }
+    if (total === 0) {
+        throw new Error('TTS 响应中没有音频数据');
+    }
+    return { audio: Buffer.concat(chunks, total), format, sampleRate, sentence, usage };
+}
+//# sourceMappingURL=tts.js.map

package/dist/lib/tts.js.map

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

package/dist/lib/types.d.ts

@@ -0,0 +1,34 @@
+export interface VolcengineCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+}
+export interface VolcengineApiRequest {
+    /** 请求方法，默认 GET */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** API Action，如 DescribeInstances */
+    action: string;
+    /** API Version，如 2020-04-01 */
+    version: string;
+    /** 服务名（签名用），如 ecs / vpc / iam / vod */
+    service: string;
+    /** 服务 Host，如 ecs.cn-north-1.volcengineapi.com；缺省时由客户端按 service/region 推导 */
+    host?: string;
+    /** 区域，默认 cn-north-1 */
+    region?: string;
+    /** 业务参数；GET 时拼接为 query，POST 时作为 JSON body */
+    params?: Record<string, unknown>;
+    /** 额外 HTTP header（不要带签名相关 header） */
+    headers?: Record<string, string>;
+}
+export interface VolcengineApiResponse<T = unknown> {
+    status: number;
+    headers: Record<string, string>;
+    body: T;
+}
+export declare class VolcengineApiError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    readonly requestId: string | undefined;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status: number, code: string | undefined, requestId: string | undefined, body?: unknown | undefined);
+}

package/dist/lib/types.js

@@ -0,0 +1,15 @@
+export class VolcengineApiError extends Error {
+    status;
+    code;
+    requestId;
+    body;
+    constructor(message, status, code, requestId, body) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.requestId = requestId;
+        this.body = body;
+        this.name = 'VolcengineApiError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AA8BA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB;IACA;IACA;IACA;IALlB,YACE,OAAe,EACC,MAAc,EACd,IAAwB,EACxB,SAA6B,EAC7B,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAoB;QACxB,cAAS,GAAT,SAAS,CAAoB;QAC7B,SAAI,GAAJ,IAAI,CAAU;QAG9B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/tools/auc.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const asrTranscribeTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        url: z.ZodOptional<z.ZodString>;
+        file_path: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodEnum<["2.0", "1.0"]>>;
+        enable_speaker_info: z.ZodOptional<z.ZodBoolean>;
+        enable_punc: z.ZodOptional<z.ZodBoolean>;
+        enable_itn: z.ZodOptional<z.ZodBoolean>;
+        ssd_version: z.ZodOptional<z.ZodEnum<["200", "300"]>>;
+        timeout_seconds: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: (args: {
+        url?: string;
+        file_path?: string;
+        format?: string;
+        language?: string;
+        model?: "2.0" | "1.0";
+        enable_speaker_info?: boolean;
+        enable_punc?: boolean;
+        enable_itn?: boolean;
+        ssd_version?: "200" | "300";
+        timeout_seconds?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/tools/auc.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { buildObjectKey, detectFormat, renderTranscriptMd, resolveTosOptions, transcribeAudio, uploadToTos, } from '../lib/index.js';
+export const asrTranscribeTool = {
+    name: 'auc_bigmodel_transcribe',
+    description: '火山引擎语音技术-大模型录音文件识别（端点 openspeech.bytedance.com/api/v3/auc/bigmodel/submit + query）。' +
+        '提交音频并轮询直到完成，返回全文、分句时间戳与说话人。音频源二选一：url（公网可访问）或 file_path（本地文件，自动上传 TOS 换取预签名地址，需 VOLC_TOS_* 配置）。需要环境变量 VOLC_ASR_API_KEY。',
+    inputSchema: {
+        url: z.string().optional().describe('音频公网 URL（与 file_path 二选一）'),
+        file_path: z.string().optional().describe('本地音频文件路径（与 url 二选一；自动上传 TOS 生成预签名 URL）'),
+        format: z
+            .string()
+            .optional()
+            .describe('音频格式（wav/mp3/ogg/spx/amr/aac/m4a）；不传时从 url/file_path 扩展名推断'),
+        language: z.string().optional().describe('语言，如 zh / en；不传自动检测'),
+        model: z.enum(['2.0', '1.0']).optional().describe('模型版本，默认 2.0（1.0 为旧版）'),
+        enable_speaker_info: z.boolean().optional().describe('是否区分说话人（说话人分离）'),
+        enable_punc: z.boolean().optional().describe('是否加标点'),
+        enable_itn: z.boolean().optional().describe('是否做数字规整（ITN）'),
+        ssd_version: z.enum(['200', '300']).optional().describe('说话人分离模型：200 非会议(≤5人) / 300 长会议声纹'),
+        timeout_seconds: z.number().int().positive().optional().describe('轮询超时（秒），默认 600'),
+    },
+    handler: async (args) => {
+        if (!args.url && !args.file_path) {
+            throw new Error('url 与 file_path 至少提供一个');
+        }
+        let audioUrl = args.url;
+        let source = audioUrl ?? args.file_path;
+        if (args.file_path) {
+            const tos = resolveTosOptions({ prefix: 'asr' });
+            const key = buildObjectKey(tos.prefix, new Date().toISOString().slice(0, 10), args.file_path);
+            const uploaded = await uploadToTos(tos, args.file_path, key);
+            audioUrl = uploaded.url;
+            source = args.file_path;
+        }
+        const format = args.format ?? detectFormat(source);
+        if (!format) {
+            throw new Error('无法从扩展名推断音频格式，请显式传 format（wav/mp3/ogg/spx/amr/aac/m4a）');
+        }
+        const apiKey = process.env.VOLC_ASR_API_KEY;
+        if (!apiKey?.trim()) {
+            throw new Error('缺少环境变量 VOLC_ASR_API_KEY（火山语音控制台的 X-Api-Key）');
+        }
+        const result = await transcribeAudio({
+            apiKey: apiKey.trim(),
+            url: audioUrl,
+            format,
+            language: args.language,
+            model: args.model,
+            enableSpeakerInfo: args.enable_speaker_info,
+            enablePunc: args.enable_punc,
+            enableItn: args.enable_itn,
+            ssdVersion: args.ssd_version,
+            timeoutMs: args.timeout_seconds ? args.timeout_seconds * 1000 : undefined,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        ok: true,
+                        task_id: result.taskId,
+                        audio_url: audioUrl,
+                        format,
+                        text: result.text,
+                        utterances_count: result.utterances.length,
+                    }, null, 2),
+                },
+                {
+                    type: 'text',
+                    text: renderTranscriptMd(result.utterances),
+                },
+            ],
+        };
+    },
+};
+//# sourceMappingURL=auc.js.map

package/dist/tools/auc.js.map

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

package/dist/tools/image.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/** 方舟密钥必须显式配置 ARK_API_KEY；ANTHROPIC_* 等环境变量不一定是火山的，不做回退 */
+export declare function resolveArkApiKey(): string;
+export declare const generateImageTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        prompt: z.ZodString;
+        output_path: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodString>;
+        watermark: z.ZodOptional<z.ZodBoolean>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>;
+    };
+    handler: (args: {
+        prompt: string;
+        output_path: string;
+        model?: string;
+        size?: string;
+        watermark?: boolean;
+        seed?: number;
+        format?: "png" | "jpeg";
+    }) => Promise<{
+        content: ({
+            type: "text";
+            text: string;
+            data?: undefined;
+            mimeType?: undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            text?: undefined;
+        })[];
+    }>;
+};

package/dist/tools/image.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { ARK_DEFAULT_IMAGE_MODEL, ARK_DEFAULT_SIZE, arkDownloadImage, arkGenerateImage, } from '../lib/index.js';
+const ARK_DEFAULT_MODEL_HINT = ARK_DEFAULT_IMAGE_MODEL;
+/** 方舟密钥必须显式配置 ARK_API_KEY；ANTHROPIC_* 等环境变量不一定是火山的，不做回退 */
+export 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();
+}
+/** 输出格式跟随落盘扩展名（.png→png、.jpg/.jpeg→jpeg），未识别时默认 png；可用 format 参数覆盖 */
+function deriveFormat(outputPath, format) {
+    if (format)
+        return format;
+    const ext = (outputPath.match(/\.([a-z0-9]+)$/i)?.[1] ?? '').toLowerCase();
+    return ext === 'jpg' || ext === 'jpeg' ? 'jpeg' : 'png';
+}
+export const generateImageTool = {
+    name: 'plan_images_generations',
+    description: '火山方舟图片生成（端点 /api/plan/v3/images/generations，Seedream 文生图）。输入 prompt 与保存路径，生成图片并落盘，同时把图片直接返回给 Agent 查看。' +
+        `默认模型 ${ARK_DEFAULT_MODEL_HINT}，默认尺寸 ${ARK_DEFAULT_SIZE}（宽x高，或 1K/2K/4K）。`,
+    inputSchema: {
+        prompt: z.string().min(1).describe('生图提示词。图上要出现的文字用「」原样写进 prompt'),
+        output_path: z.string().min(1).describe('图片保存的绝对路径（.png 或 .jpg，格式跟随扩展名）'),
+        model: z.string().optional().describe(`模型 ID，默认 ${ARK_DEFAULT_MODEL_HINT}`),
+        size: z.string().optional().describe('图片尺寸，宽x高如 2048x1152，或 1K/2K/4K，默认 1728x2304'),
+        watermark: z.boolean().optional().describe('是否加水印，默认 false'),
+        seed: z.number().int().optional().describe('随机种子，固定 seed 可复现同一张图'),
+        format: z.enum(['png', 'jpeg']).optional().describe('覆盖输出格式（默认跟随 output_path 扩展名）'),
+    },
+    handler: async (args) => {
+        const apiKey = resolveArkApiKey();
+        const outputFormat = deriveFormat(args.output_path, args.format);
+        const result = await arkGenerateImage({
+            apiKey,
+            prompt: args.prompt,
+            model: args.model,
+            size: args.size,
+            watermark: args.watermark,
+            seed: args.seed,
+            outputFormat,
+        });
+        const { path, bytes } = await arkDownloadImage(result.url, args.output_path);
+        const mimeType = result.outputFormat === 'jpeg' ? 'image/jpeg' : 'image/png';
+        const base64 = (await import('node:fs')).readFileSync(path).toString('base64');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ ok: true, model: result.model, output: path, size: result.size, format: result.outputFormat, bytes }, null, 2),
+                },
+                { type: 'image', data: base64, mimeType },
+            ],
+        };
+    },
+};
+//# sourceMappingURL=image.js.map

package/dist/tools/image.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export declare const webSearchTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        query: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+        search_type: z.ZodOptional<z.ZodEnum<["web", "image"]>>;
+        time_range: z.ZodOptional<z.ZodString>;
+        auth_level: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+        need_content: z.ZodOptional<z.ZodBoolean>;
+        need_url: z.ZodOptional<z.ZodBoolean>;
+        sites: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        block_hosts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        industry: z.ZodOptional<z.ZodEnum<["finance", "game", "gov"]>>;
+        query_rewrite: z.ZodOptional<z.ZodBoolean>;
+        content_formats: z.ZodOptional<z.ZodEnum<["text", "markdown"]>>;
+    };
+    handler: (args: {
+        query: string;
+        count?: number;
+        search_type?: "web" | "image";
+        time_range?: string;
+        auth_level?: 0 | 1;
+        need_content?: boolean;
+        need_url?: boolean;
+        sites?: string[];
+        block_hosts?: string[];
+        industry?: "finance" | "game" | "gov";
+        query_rewrite?: boolean;
+        content_formats?: "text" | "markdown";
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/tools/search.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { buildWebSearchPayload, webSearchByAkSk, webSearchByApiKey } from '../lib/index.js';
+/** 鉴权二选一：搜索 API Key（feedcoopapi 网关）或火山 AK/SK（V4 签名 mercury 网关） */
+function resolveSearchAuth() {
+    const apiKey = process.env.ASK_ECHO_SEARCH_INFINITY_API_KEY;
+    if (apiKey?.trim())
+        return { mode: 'api-key', apiKey: apiKey.trim() };
+    const ak = process.env.VOLCENGINE_ACCESS_KEY;
+    const sk = process.env.VOLCENGINE_SECRET_KEY;
+    if (ak?.trim() && sk?.trim())
+        return { mode: 'ak-sk', ak: ak.trim(), sk: sk.trim() };
+    throw new Error('缺少搜索鉴权配置，请设置环境变量 ASK_ECHO_SEARCH_INFINITY_API_KEY，或同时设置 VOLCENGINE_ACCESS_KEY / VOLCENGINE_SECRET_KEY');
+}
+export const webSearchTool = {
+    name: 'askecho_web_search',
+    description: '火山引擎联网搜索（豆包搜索，服务 volc_torchlight_api，Action WebSearch）。支持网页与图片搜索，可按时间/站点/行业过滤、返回正文。' +
+        '鉴权二选一：ASK_ECHO_SEARCH_INFINITY_API_KEY 或 VOLCENGINE_ACCESS_KEY + VOLCENGINE_SECRET_KEY。',
+    inputSchema: {
+        query: z.string().min(1).max(100).describe('搜索 query，1~100 个字符'),
+        count: z.number().int().optional().describe('返回条数，web 默认 10（最多 50），image 默认 5（最多 5）'),
+        search_type: z.enum(['web', 'image']).optional().describe('搜索类型，默认 web'),
+        time_range: z.string().optional().describe('时间范围，OneDay/OneWeek/OneMonth/OneYear 或 YYYY-MM-DD..YYYY-MM-DD，仅 web'),
+        auth_level: z.union([z.literal(0), z.literal(1)]).optional().describe('权威等级过滤，1 = 非常权威，仅 web'),
+        need_content: z.boolean().optional().describe('是否返回网页正文，仅 web'),
+        need_url: z.boolean().optional().describe('是否返回网页 URL，仅 web'),
+        sites: z.array(z.string()).optional().describe('仅搜索指定站点，最多 20 个，仅 web'),
+        block_hosts: z.array(z.string()).optional().describe('排除指定站点，最多 5 个，仅 web'),
+        industry: z.enum(['finance', 'game', 'gov']).optional().describe('行业搜索，仅 web'),
+        query_rewrite: z.boolean().optional().describe('是否启用查询改写'),
+        content_formats: z.enum(['text', 'markdown']).optional().describe('网页正文格式，仅 web'),
+    },
+    handler: async (args) => {
+        const payload = buildWebSearchPayload({
+            query: args.query,
+            count: args.count,
+            searchType: args.search_type,
+            timeRange: args.time_range,
+            authLevel: args.auth_level,
+            needContent: args.need_content,
+            needUrl: args.need_url,
+            sites: args.sites,
+            blockHosts: args.block_hosts,
+            industry: args.industry,
+            queryRewrite: args.query_rewrite,
+            contentFormats: args.content_formats,
+        });
+        const auth = resolveSearchAuth();
+        const body = auth.mode === 'api-key'
+            ? await webSearchByApiKey(auth.apiKey, payload)
+            : await webSearchByAkSk({ accessKeyId: auth.ak, secretAccessKey: auth.sk }, payload);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(body, null, 2) }],
+        };
+    },
+};
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/tos.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+export declare const tosPutObjectTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        file_path: z.ZodString;
+        key: z.ZodOptional<z.ZodString>;
+        prefix: z.ZodOptional<z.ZodString>;
+        expires: z.ZodOptional<z.ZodNumber>;
+        content_type: z.ZodOptional<z.ZodString>;
+        bucket: z.ZodOptional<z.ZodString>;
+        region: z.ZodOptional<z.ZodString>;
+        endpoint: z.ZodOptional<z.ZodString>;
+    };
+    handler: (args: {
+        file_path: string;
+        key?: string;
+        prefix?: string;
+        expires?: number;
+        content_type?: string;
+        bucket?: string;
+        region?: string;
+        endpoint?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/tools/tos.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { buildObjectKey, resolveTosOptions, uploadToTos } from '../lib/index.js';
+export const tosPutObjectTool = {
+    name: 'tos_object_put',
+    description: '上传本地文件到火山引擎 TOS（API Action: PutObject，对应工具名 tos_object_put = 服务_资源_动作），bucket 保持私有，返回预签名下载 URL（默认 24h 有效）。' +
+        '对象 key 默认为 <prefix>/<YYYY-MM-DD>/<文件名>。需要环境变量 VOLC_TOS_ACCESS_KEY / VOLC_TOS_SECRET_KEY / VOLC_TOS_BUCKET / VOLC_TOS_REGION。',
+    inputSchema: {
+        file_path: z.string().min(1).describe('要上传的本地文件路径（绝对路径）'),
+        key: z.string().optional().describe('完整对象 key；不传则自动生成 <prefix>/<日期>/<文件名>'),
+        prefix: z.string().optional().describe('key 前缀，默认取 VOLC_TOS_PREFIX，再默认 volcengine-api-mcp'),
+        expires: z.number().int().positive().optional().describe('预签名 URL 有效期（秒），默认 86400（24h）'),
+        content_type: z.string().optional().describe('覆盖 Content-Type（默认按扩展名推导，未知类型为 application/octet-stream）'),
+        bucket: z.string().optional().describe('覆盖默认 bucket'),
+        region: z.string().optional().describe('覆盖默认 region'),
+        endpoint: z.string().optional().describe('覆盖默认 endpoint'),
+    },
+    handler: async (args) => {
+        const opts = resolveTosOptions({ bucket: args.bucket, region: args.region, endpoint: args.endpoint, prefix: args.prefix });
+        const key = args.key ?? buildObjectKey(opts.prefix, new Date().toISOString().slice(0, 10), args.file_path);
+        const result = await uploadToTos(opts, args.file_path, key, args.expires, args.content_type);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        ok: true,
+                        bucket: result.bucket,
+                        key: result.key,
+                        bytes: result.bytes,
+                        url: result.url,
+                        url_expires_seconds: args.expires ?? 86_400,
+                    }, null, 2),
+                },
+            ],
+        };
+    },
+};
+//# sourceMappingURL=tos.js.map

package/dist/tools/tos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tos.js","sourceRoot":"","sources":["../../src/tools/tos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEjF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,4GAA4G;QAC5G,8HAA8H;IAChI,WAAW,EAAE;QACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACzD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAC3E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;QAC3F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACxF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;QACxG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QACrD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;KAC1D;IACD,OAAO,EAAE,KAAK,EAAE,IASf,EAAE,EAAE;QACH,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3H,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAE3G,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAE7F,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,EAAE,EAAE,IAAI;wBACR,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,mBAAmB,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM;qBAC5C,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/tts.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+export declare const ttsUnidirectionalTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        text: z.ZodString;
+        output_path: z.ZodString;
+        speaker: z.ZodOptional<z.ZodString>;
+        resource_id: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodEnum<["mp3", "pcm", "ogg_opus", "wav"]>>;
+        sample_rate: z.ZodOptional<z.ZodNumber>;
+        speech_rate: z.ZodOptional<z.ZodNumber>;
+        loudness_rate: z.ZodOptional<z.ZodNumber>;
+        enable_subtitle: z.ZodOptional<z.ZodBoolean>;
+        explicit_language: z.ZodOptional<z.ZodString>;
+    };
+    handler: (args: {
+        text: string;
+        output_path: string;
+        speaker?: string;
+        resource_id?: string;
+        model?: string;
+        format?: "mp3" | "pcm" | "ogg_opus" | "wav";
+        sample_rate?: number;
+        speech_rate?: number;
+        loudness_rate?: number;
+        enable_subtitle?: boolean;
+        explicit_language?: string;
+    }) => Promise<{
+        content: ({
+            type: "text";
+            text: string;
+            data?: undefined;
+            mimeType?: undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            text?: undefined;
+        })[];
+    }>;
+};