mcp-message-test 1.0.0

package/README.md

@@ -0,0 +1,79 @@
+# tool-message-test-mcp
+
+一个用于测试 MCP Tool 各种消息类型返回的测试服务器。覆盖了文本、图片、音频、资源链接、嵌入式资源、结构化内容、annotations 以及各种边界/异常 case。
+
+## 使用
+
+### 通过 bunx 直接运行（无需 clone）
+
+```bash
+bunx github:acdzh/tool-message-test-mcp
+```
+
+### 本地开发
+
+```bash
+# 安装依赖
+bun install
+
+# 运行
+bun run index.ts
+```
+
+### 在 MCP 客户端中配置
+
+```json
+{
+  "mcpServers": {
+    "message-test": {
+      "command": "npx",
+      "args": ["mcp-message-test"]
+    }
+  }
+}
+```
+
+```json
+{
+  "mcpServers": {
+    "message-test": {
+      "command": "bunx",
+      "args": ["github:acdzh/tool-message-test-mcp"]
+    }
+  }
+}
+```
+
+```json
+{
+  "mcpServers": {
+    "message-test": {
+      "command": "bun run",
+      "args": ["/Users/admin/dev/work/mcp/server/message-test/index.ts"]
+    }
+  }
+}
+```
+
+## 提供的 Tools
+
+| Tool | 描述 |
+|------|------|
+| `test_text` | 各种文本内容（plain/multi/markdown/unicode/long/empty） |
+| `test_image` | 图片 base64 编码（png/jpg/gif/webp/svg/multi） |
+| `test_image_uri` | image-uri 类型（basic/full/multi_scheme） |
+| `test_audio` | 音频 base64 编码（wav/mp3） |
+| `test_resource_link` | 资源链接（basic/full） |
+| `test_embedded_resource` | 嵌入式资源（text/blob/with_annotations） |
+| `test_mixed_content` | 混合所有标准内容类型 |
+| `test_annotations` | Annotations 测试 |
+| `test_structured_content` | 结构化内容 + outputSchema |
+| `test_error` | 错误响应 |
+| `test_large_content` | 大量 content items |
+| `test_invalid_types` | 非法内容类型 |
+| `test_invalid_structure` | 非法 content 结构 |
+| `test_invalid_fields` | 字段缺失或错误 |
+| `test_invalid_annotations` | 非法 annotations |
+| `test_invalid_result_fields` | 非法结果字段 |
+| `test_throws` | 工具抛出异常 |
+| `test_mixed_valid_invalid` | 混合有效和无效 items |

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { McpServer, StdioServerTransport } from '@byted/modelcontextprotocol-server';
+import { registerGenText } from './tools/gen_text.js';
+import { registerGenImage } from './tools/gen_image.js';
+import { registerGenImageUri } from './tools/gen_image_uri.js';
+import { registerGenAudio } from './tools/gen_audio.js';
+import { registerGenResourceLink } from './tools/gen_resource_link.js';
+import { registerGenEmbeddedResource } from './tools/gen_embedded_resource.js';
+import { registerGenMixed } from './tools/gen_mixed.js';
+import { registerGenInvalid } from './tools/gen_invalid.js';
+const server = new McpServer({ name: 'message-test-server', version: '2.0.0' }, { capabilities: { tools: { listChanged: false } } });
+// 注册所有 tools
+registerGenText(server);
+registerGenImage(server);
+registerGenImageUri(server);
+registerGenAudio(server);
+registerGenResourceLink(server);
+registerGenEmbeddedResource(server);
+registerGenMixed(server);
+registerGenInvalid(server);
+// 启动服务器
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/schemas.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod/v4';
+export declare const annotationsSchema: z.ZodOptional<z.ZodObject<{
+    audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+    }>>>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+export declare const structuredSchema: z.ZodDefault<z.ZodBoolean>;

package/dist/schemas.js

@@ -0,0 +1,6 @@
+import { z } from 'zod/v4';
+export const annotationsSchema = z.object({
+    audience: z.array(z.enum(['user', 'assistant'])).optional().describe('内容受众'),
+    priority: z.number().min(0).max(1).optional().describe('优先级 0-1'),
+}).optional().describe('MCP annotations，不传则不附加');
+export const structuredSchema = z.boolean().default(false).describe('是否额外返回 structuredContent');

package/dist/tools/gen_audio.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@byted/modelcontextprotocol-server';
+export declare function registerGenAudio(server: McpServer): void;

package/dist/tools/gen_audio.js

@@ -0,0 +1,41 @@
+import { z } from 'zod/v4';
+import { annotationsSchema, structuredSchema } from '../schemas.js';
+import { buildAnnotations, generateWav, generateMelodyWav } from '../utils/index.js';
+export function registerGenAudio(server) {
+    server.registerTool('gen_audio', {
+        title: 'Generate Audio',
+        description: '本地生成音频，返回 base64 编码。支持单音正弦波或随机旋律',
+        inputSchema: z.object({
+            duration_ms: z.number().min(100).max(30000).default(2000).describe('音频时长（毫秒）'),
+            mode: z.enum(['tone', 'melody']).default('melody').describe('tone: 单一频率正弦波; melody: 随机旋律'),
+            frequency: z.number().min(20).max(20000).default(440).describe('频率 Hz（仅 tone 模式有效）'),
+            count: z.number().min(1).max(10).default(1).describe('音频数量'),
+            annotations: annotationsSchema,
+            structured: structuredSchema,
+        }),
+    }, async ({ duration_ms, mode, frequency, count, annotations, structured }) => {
+        const ann = buildAnnotations(annotations);
+        const content = Array.from({ length: count }, (_, i) => {
+            let wav;
+            if (mode === 'melody') {
+                wav = generateMelodyWav(duration_ms);
+            }
+            else {
+                // 每个用不同频率增加变化
+                const freq = frequency + i * 50;
+                wav = generateWav(duration_ms, freq);
+            }
+            return {
+                type: 'audio',
+                data: wav.toString('base64'),
+                mimeType: 'audio/wav',
+                ...(ann ? { annotations: ann } : {}),
+            };
+        });
+        const result = { content };
+        if (structured) {
+            result.structuredContent = { duration_ms, mode, frequency, count, generatedAt: new Date().toISOString() };
+        }
+        return result;
+    });
+}

package/dist/tools/gen_embedded_resource.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@byted/modelcontextprotocol-server';
+export declare function registerGenEmbeddedResource(server: McpServer): void;

package/dist/tools/gen_embedded_resource.js

@@ -0,0 +1,52 @@
+import { z } from 'zod/v4';
+import { resolve } from 'path';
+import { annotationsSchema, structuredSchema } from '../schemas.js';
+import { assetsDir, loadAssetBase64, loadAssetText, buildAnnotations, randPick } from '../utils/index.js';
+export function registerGenEmbeddedResource(server) {
+    server.registerTool('gen_embedded_resource', {
+        title: 'Generate Embedded Resource',
+        description: '生成嵌入式资源内容（text 或 blob）',
+        inputSchema: z.object({
+            resource_type: z.enum(['text', 'blob']).default('text').describe('资源类型'),
+            count: z.number().min(1).max(20).default(1).describe('数量'),
+            annotations: annotationsSchema,
+            structured: structuredSchema,
+        }),
+    }, async ({ resource_type, count, annotations, structured }) => {
+        const ann = buildAnnotations(annotations);
+        const content = Array.from({ length: count }, () => {
+            if (resource_type === 'text') {
+                const files = ['sample.ts', 'sample.txt'];
+                const file = randPick(files);
+                const mime = file.endsWith('.ts') ? 'text/typescript' : 'text/plain';
+                return {
+                    type: 'resource',
+                    resource: {
+                        uri: `file://${resolve(assetsDir, file)}`,
+                        mimeType: mime,
+                        text: loadAssetText(file),
+                        ...(ann ? { annotations: ann } : {}),
+                    },
+                };
+            }
+            // blob
+            const files = ['sample.png', 'sample.jpg', 'sample.webp'];
+            const file = randPick(files);
+            const mimeMap = { 'sample.png': 'image/png', 'sample.jpg': 'image/jpeg', 'sample.webp': 'image/webp' };
+            return {
+                type: 'resource',
+                resource: {
+                    uri: `file://${resolve(assetsDir, file)}`,
+                    mimeType: mimeMap[file],
+                    blob: loadAssetBase64(file),
+                    ...(ann ? { annotations: ann } : {}),
+                },
+            };
+        });
+        const result = { content };
+        if (structured) {
+            result.structuredContent = { resource_type, count, generatedAt: new Date().toISOString() };
+        }
+        return result;
+    });
+}

package/dist/tools/gen_image.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@byted/modelcontextprotocol-server';
+export declare function registerGenImage(server: McpServer): void;

package/dist/tools/gen_image.js

@@ -0,0 +1,90 @@
+import { z } from 'zod/v4';
+import sharp from 'sharp';
+import { annotationsSchema, structuredSchema } from '../schemas.js';
+import { buildAnnotations } from '../utils/index.js';
+/** 从 picsum 获取一张真实照片 buffer */
+async function fetchPicsumBuffer(width, height, seed) {
+    const url = `https://picsum.photos/${width}/${height}.jpg?random=${seed}`;
+    const resp = await fetch(url, { redirect: 'follow' });
+    if (!resp.ok)
+        throw new Error(`Fetch failed: ${resp.status} ${resp.statusText}`);
+    return Buffer.from(await resp.arrayBuffer());
+}
+/** 用多张图拼成动态 GIF */
+async function generateAnimatedGif(width, height, frameCount = 4) {
+    // 获取多张不同的真实照片作为帧
+    const frames = await Promise.all(Array.from({ length: frameCount }, (_, i) => fetchPicsumBuffer(width, height, Date.now() + i * 1000 + Math.random() * 9999)));
+    // 将每帧转为统一尺寸的 raw RGBA 数据
+    const rawFrames = [];
+    for (const frame of frames) {
+        const raw = await sharp(frame).resize(width, height).ensureAlpha().raw().toBuffer();
+        rawFrames.push(raw);
+    }
+    // 将所有帧垂直拼接成一个 tall image (width x height*frameCount)
+    const combined = Buffer.concat(rawFrames);
+    // sharp 通过 raw input + pages 参数识别为多帧动图
+    return sharp(combined, {
+        raw: {
+            width,
+            height: height * frameCount,
+            channels: 4,
+        },
+    })
+        .gif({
+        delay: Array(frameCount).fill(500),
+        loop: 0,
+    })
+        .toBuffer();
+}
+export function registerGenImage(server) {
+    server.registerTool('gen_image', {
+        title: 'Generate Image',
+        description: '获取随机真实图片，返回 base64 编码。gif 为多帧动图',
+        inputSchema: z.object({
+            width: z.number().min(1).max(4096).default(400).describe('图片宽度'),
+            height: z.number().min(1).max(4096).default(300).describe('图片高度'),
+            format: z.enum(['jpg', 'png', 'webp', 'gif', 'avif']).default('jpg').describe('图片格式'),
+            count: z.number().min(1).max(20).default(1).describe('图片数量'),
+            gif_frames: z.number().min(2).max(10).default(4).describe('GIF 动图帧数（仅 gif 格式有效）'),
+            annotations: annotationsSchema,
+            structured: structuredSchema,
+        }),
+    }, async ({ width, height, format, count, gif_frames, annotations, structured }) => {
+        const mimeMap = {
+            jpg: 'image/jpeg',
+            png: 'image/png',
+            webp: 'image/webp',
+            gif: 'image/gif',
+            avif: 'image/avif',
+        };
+        const ann = buildAnnotations(annotations);
+        const content = await Promise.all(Array.from({ length: count }, async (_, i) => {
+            let outputBuffer;
+            if (format === 'gif') {
+                // GIF: 获取多张照片拼成动图
+                outputBuffer = await generateAnimatedGif(width, height, gif_frames);
+            }
+            else {
+                // 其他格式: 获取单张照片，按需转换
+                const srcBuffer = await fetchPicsumBuffer(width, height, Date.now() + i);
+                if (format === 'jpg') {
+                    outputBuffer = srcBuffer;
+                }
+                else {
+                    outputBuffer = await sharp(srcBuffer).toFormat(format).toBuffer();
+                }
+            }
+            return {
+                type: 'image',
+                data: outputBuffer.toString('base64'),
+                mimeType: mimeMap[format],
+                ...(ann ? { annotations: ann } : {}),
+            };
+        }));
+        const result = { content };
+        if (structured) {
+            result.structuredContent = { width, height, format, count, generatedAt: new Date().toISOString() };
+        }
+        return result;
+    });
+}

package/dist/tools/gen_image_uri.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@byted/modelcontextprotocol-server';
+export declare function registerGenImageUri(server: McpServer): void;

package/dist/tools/gen_image_uri.js

@@ -0,0 +1,30 @@
+import { z } from 'zod/v4';
+import { annotationsSchema, structuredSchema } from '../schemas.js';
+import { buildAnnotations, randInt } from '../utils/index.js';
+export function registerGenImageUri(server) {
+    server.registerTool('gen_image_uri', {
+        title: 'Generate Image URI',
+        description: '返回 image-uri 类型的图片引用（真实可访问的 URL）',
+        inputSchema: z.object({
+            width: z.number().min(1).max(4096).default(400).describe('图片宽度'),
+            height: z.number().min(1).max(4096).default(300).describe('图片高度'),
+            count: z.number().min(1).max(20).default(1).describe('数量'),
+            annotations: annotationsSchema,
+            structured: structuredSchema,
+        }),
+    }, async ({ width, height, count, annotations, structured }) => {
+        const ann = buildAnnotations(annotations);
+        const content = Array.from({ length: count }, (_, i) => ({
+            type: 'image-uri',
+            // picsum 的 URL 会 302 到真实图片，每次带不同随机种子保证不同
+            uri: `https://picsum.photos/${width}/${height}?random=${Date.now()}_${i}_${randInt(1000, 9999)}`,
+            mimeType: 'image/jpeg',
+            ...(ann ? { annotations: ann } : {}),
+        }));
+        const result = { content };
+        if (structured) {
+            result.structuredContent = { width, height, count, generatedAt: new Date().toISOString() };
+        }
+        return result;
+    });
+}

package/dist/tools/gen_invalid.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@byted/modelcontextprotocol-server';
+export declare function registerGenInvalid(server: McpServer): void;

package/dist/tools/gen_invalid.js

@@ -0,0 +1,124 @@
+import { z } from 'zod/v4';
+import { resolve } from 'path';
+import { assetsDir, loadAssetBase64, randSentence, randInt } from '../utils/index.js';
+export function registerGenInvalid(server) {
+    server.registerTool('gen_invalid', {
+        title: 'Generate Invalid Response',
+        description: '生成各种不符合规范的响应，用于测试客户端的健壮性',
+        inputSchema: z.object({
+            kind: z.enum([
+                // 错误响应
+                'is_error',
+                'is_error_detailed',
+                'is_error_wrong_type',
+                // 抛出异常
+                'throws',
+                // 非法类型
+                'unknown_type',
+                'empty_type',
+                'missing_type',
+                'wrong_field_type',
+                // 非法结构
+                'empty_content',
+                'null_content',
+                'not_array',
+                'no_content_field',
+                'null_item',
+                'returns_undefined',
+                // 非法字段
+                'image_no_data',
+                'image_no_mime',
+                'bad_base64',
+                'audio_no_mime',
+                'image_uri_no_uri',
+                'resource_link_no_uri',
+                'resource_no_resource',
+                // 非法 annotations
+                'annotations_wrong_type',
+                'annotations_bad_priority',
+                'annotations_bad_audience',
+                'extra_fields',
+                // 混合有效和无效
+                'mixed_valid_invalid',
+            ]).describe('异常类型'),
+        }),
+    }, async ({ kind }) => {
+        switch (kind) {
+            // --- 错误响应 ---
+            case 'is_error':
+                return { content: [{ type: 'text', text: `Error: ${randSentence()}` }], isError: true };
+            case 'is_error_detailed':
+                return {
+                    content: [
+                        { type: 'text', text: 'Error: API rate limit exceeded.' },
+                        { type: 'text', text: `Retry after: ${randInt(10, 120)} seconds.` },
+                        { type: 'text', text: `Request ID: req-${crypto.randomUUID().slice(0, 8)}` },
+                    ],
+                    isError: true,
+                };
+            case 'is_error_wrong_type':
+                return { content: [{ type: 'text', text: 'Error flag is wrong type.' }], isError: 'yes' };
+            // --- 抛出异常 ---
+            case 'throws':
+                throw new Error(`Unexpected server error: ${randSentence()}`);
+            // --- 非法类型 ---
+            case 'unknown_type':
+                return { content: [{ type: 'video', data: 'some-data', mimeType: 'video/mp4' }] };
+            case 'empty_type':
+                return { content: [{ type: '', text: randSentence() }] };
+            case 'missing_type':
+                return { content: [{ text: randSentence() }] };
+            case 'wrong_field_type':
+                return { content: [{ type: 'text', text: randInt(1, 99999) }] };
+            // --- 非法结构 ---
+            case 'empty_content':
+                return { content: [] };
+            case 'null_content':
+                return { content: null };
+            case 'not_array':
+                return { content: { type: 'text', text: randSentence() } };
+            case 'no_content_field':
+                return { result: randSentence() };
+            case 'null_item':
+                return { content: [{ type: 'text', text: 'Valid.' }, null, { type: 'text', text: 'Also valid.' }] };
+            case 'returns_undefined':
+                return undefined;
+            // --- 非法字段 ---
+            case 'image_no_data':
+                return { content: [{ type: 'image', mimeType: 'image/png' }] };
+            case 'image_no_mime':
+                return { content: [{ type: 'image', data: loadAssetBase64('sample.png') }] };
+            case 'bad_base64':
+                return { content: [{ type: 'image', data: '!!!not-valid-base64@@@###', mimeType: 'image/png' }] };
+            case 'audio_no_mime':
+                return { content: [{ type: 'audio', data: loadAssetBase64('sample_3s.mp3') }] };
+            case 'image_uri_no_uri':
+                return { content: [{ type: 'image-uri', mimeType: 'image/png' }] };
+            case 'resource_link_no_uri':
+                return { content: [{ type: 'resource_link', description: 'A link with no URI or name' }] };
+            case 'resource_no_resource':
+                return { content: [{ type: 'resource' }] };
+            // --- 非法 annotations ---
+            case 'annotations_wrong_type':
+                return { content: [{ type: 'text', text: randSentence(), annotations: 'should-be-an-object' }] };
+            case 'annotations_bad_priority':
+                return { content: [{ type: 'text', text: randSentence(), annotations: { audience: ['user'], priority: 99.9 } }] };
+            case 'annotations_bad_audience':
+                return { content: [{ type: 'text', text: randSentence(), annotations: { audience: ['user', 'robot', 'admin'], priority: 0.5 } }] };
+            case 'extra_fields':
+                return { content: [{ type: 'text', text: randSentence(), unknownField1: 'value1', unknownField2: 42, nested: { deep: true } }] };
+            // --- 混合有效和无效 ---
+            case 'mixed_valid_invalid':
+                return {
+                    content: [
+                        { type: 'text', text: 'Valid text item.' },
+                        { type: 'unknown_type', data: 'mystery' },
+                        { type: 'image', data: '!!!not-base64', mimeType: 'image/png' },
+                        { type: 'text', text: 'Another valid text.' },
+                        null,
+                        { type: 'resource_link', uri: `file://${resolve(assetsDir, 'sample.txt')}`, name: 'sample.txt' },
+                    ],
+                };
+        }
+    });
+}

package/dist/tools/gen_mixed.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@byted/modelcontextprotocol-server';
+export declare function registerGenMixed(server: McpServer): void;

package/dist/tools/gen_mixed.js

@@ -0,0 +1,68 @@
+import { z } from 'zod/v4';
+import { resolve } from 'path';
+import { annotationsSchema, structuredSchema } from '../schemas.js';
+import { assetsDir, fetchBase64, loadAssetText, buildAnnotations, randInt, randPick, randParagraph, generateWav } from '../utils/index.js';
+export function registerGenMixed(server) {
+    server.registerTool('gen_mixed', {
+        title: 'Generate Mixed Content',
+        description: '在一次响应中返回多种内容类型的混合',
+        inputSchema: z.object({
+            types: z.array(z.enum(['text', 'image', 'image_uri', 'audio', 'resource_link', 'resource']))
+                .default(['text', 'image', 'resource_link'])
+                .describe('要包含的内容类型'),
+            count_per_type: z.number().min(1).max(5).default(1).describe('每种类型的数量'),
+            annotations: annotationsSchema,
+            structured: structuredSchema,
+        }),
+    }, async ({ types, count_per_type, annotations, structured }) => {
+        const ann = buildAnnotations(annotations);
+        const content = [];
+        for (const type of types) {
+            for (let i = 0; i < count_per_type; i++) {
+                switch (type) {
+                    case 'text':
+                        content.push({ type: 'text', text: randParagraph(3), ...(ann ? { annotations: ann } : {}) });
+                        break;
+                    case 'image': {
+                        const w = randInt(200, 600);
+                        const h = randInt(200, 400);
+                        const { data, mimeType } = await fetchBase64(`https://picsum.photos/${w}/${h}?random=${Date.now()}_${i}`);
+                        content.push({ type: 'image', data, mimeType, ...(ann ? { annotations: ann } : {}) });
+                        break;
+                    }
+                    case 'image_uri':
+                        content.push({
+                            type: 'image-uri', uri: `https://picsum.photos/${randInt(200, 600)}/${randInt(200, 400)}?random=${Date.now()}_${i}`,
+                            mimeType: 'image/jpeg', ...(ann ? { annotations: ann } : {}),
+                        });
+                        break;
+                    case 'audio': {
+                        const wav = generateWav(randInt(500, 2000), randInt(200, 800));
+                        content.push({ type: 'audio', data: wav.toString('base64'), mimeType: 'audio/wav', ...(ann ? { annotations: ann } : {}) });
+                        break;
+                    }
+                    case 'resource_link': {
+                        const file = randPick(['sample.ts', 'sample.txt', 'sample.png']);
+                        content.push({
+                            type: 'resource_link', uri: `file://${resolve(assetsDir, file)}`,
+                            name: file, mimeType: 'application/octet-stream', ...(ann ? { annotations: ann } : {}),
+                        });
+                        break;
+                    }
+                    case 'resource':
+                        content.push({
+                            type: 'resource',
+                            resource: { uri: `file://${resolve(assetsDir, 'sample.txt')}`, mimeType: 'text/plain', text: loadAssetText('sample.txt') },
+                            ...(ann ? { annotations: ann } : {}),
+                        });
+                        break;
+                }
+            }
+        }
+        const result = { content };
+        if (structured) {
+            result.structuredContent = { types, count_per_type, generatedAt: new Date().toISOString() };
+        }
+        return result;
+    });
+}

package/dist/tools/gen_resource_link.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@byted/modelcontextprotocol-server';
+export declare function registerGenResourceLink(server: McpServer): void;

package/dist/tools/gen_resource_link.js

@@ -0,0 +1,84 @@
+import { z } from 'zod/v4';
+import { writeFileSync, mkdirSync } from 'fs';
+import { resolve } from 'path';
+import { tmpdir } from 'os';
+import { annotationsSchema, structuredSchema } from '../schemas.js';
+import { buildAnnotations, randPick, randInt, randParagraph, randSentence, generateWav } from '../utils/index.js';
+/** 在临时目录下生成随机文件，返回文件路径和元信息 */
+function generateTempFile() {
+    const tempBase = resolve(tmpdir(), 'mcp-message-test');
+    mkdirSync(tempBase, { recursive: true });
+    const id = crypto.randomUUID().slice(0, 8);
+    const generators = [
+        () => {
+            const name = `text_${id}.txt`;
+            const content = randParagraph(randInt(3, 10));
+            const filePath = resolve(tempBase, name);
+            writeFileSync(filePath, content, 'utf-8');
+            return { path: filePath, name, mime: 'text/plain', desc: 'Generated plain text file' };
+        },
+        () => {
+            const name = `code_${id}.ts`;
+            const content = `interface ${randPick(['User', 'Config', 'State'])} {\n  id: string;\n  value: ${randInt(1, 999)};\n}\n\nexport function process(): void {\n  console.log("${randSentence()}");\n}\n`;
+            const filePath = resolve(tempBase, name);
+            writeFileSync(filePath, content, 'utf-8');
+            return { path: filePath, name, mime: 'text/typescript', desc: 'Generated TypeScript file' };
+        },
+        () => {
+            const name = `data_${id}.json`;
+            const content = JSON.stringify({
+                id: crypto.randomUUID(),
+                timestamp: new Date().toISOString(),
+                values: Array.from({ length: randInt(3, 8) }, () => randInt(1, 1000)),
+                message: randSentence(),
+            }, null, 2);
+            const filePath = resolve(tempBase, name);
+            writeFileSync(filePath, content, 'utf-8');
+            return { path: filePath, name, mime: 'application/json', desc: 'Generated JSON data file' };
+        },
+        () => {
+            const name = `audio_${id}.wav`;
+            const wav = generateWav(randInt(500, 2000), randInt(200, 800));
+            const filePath = resolve(tempBase, name);
+            writeFileSync(filePath, wav);
+            return { path: filePath, name, mime: 'audio/wav', desc: 'Generated WAV audio file' };
+        },
+        () => {
+            const name = `config_${id}.yaml`;
+            const content = `name: ${randPick(['app', 'service', 'worker'])}-${id}\nversion: ${randInt(1, 5)}.${randInt(0, 9)}.${randInt(0, 20)}\nport: ${randInt(3000, 9000)}\ndebug: ${randPick(['true', 'false'])}\nlogLevel: ${randPick(['info', 'warn', 'error', 'debug'])}\n`;
+            const filePath = resolve(tempBase, name);
+            writeFileSync(filePath, content, 'utf-8');
+            return { path: filePath, name, mime: 'text/yaml', desc: 'Generated YAML config file' };
+        },
+    ];
+    return randPick(generators)();
+}
+export function registerGenResourceLink(server) {
+    server.registerTool('gen_resource_link', {
+        title: 'Generate Resource Link',
+        description: '动态生成文件到临时目录，返回 resource_link',
+        inputSchema: z.object({
+            count: z.number().min(1).max(20).default(1).describe('数量'),
+            annotations: annotationsSchema,
+            structured: structuredSchema,
+        }),
+    }, async ({ count, annotations, structured }) => {
+        const ann = buildAnnotations(annotations);
+        const content = Array.from({ length: count }, () => {
+            const file = generateTempFile();
+            return {
+                type: 'resource_link',
+                uri: `file://${file.path}`,
+                name: file.name,
+                description: file.desc,
+                mimeType: file.mime,
+                ...(ann ? { annotations: ann } : {}),
+            };
+        });
+        const result = { content };
+        if (structured) {
+            result.structuredContent = { count, generatedAt: new Date().toISOString() };
+        }
+        return result;
+    });
+}

package/dist/tools/gen_text.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@byted/modelcontextprotocol-server';
+export declare function registerGenText(server: McpServer): void;