@douyinfe/semi-mcp 1.0.19 → 1.0.21

package/dist/stdio.js

@@ -0,0 +1,1454 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { existsSync as external_fs_existsSync, readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join as external_path_join } from "path";
+import { homedir } from "os";
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { lt } from "semver";
+import { parseSync } from "oxc-parser";
+import axios from "axios";
+function getCacheDir() {
+    return external_path_join(homedir(), '.semi-mcp', 'cache');
+}
+function file_cache_getDirectoryListCacheDir() {
+    return external_path_join(getCacheDir(), 'directory-list');
+}
+function file_cache_getFileContentCacheDir() {
+    return external_path_join(getCacheDir(), 'file-content');
+}
+function keyToFileName(key) {
+    return key.replace(/@/g, '_at_').replace(/\//g, '_').replace(/\\/g, '_').replace(/:/g, '_').replace(/\*/g, '_').replace(/\?/g, '_').replace(/"/g, '_').replace(/</g, '_').replace(/>/g, '_').replace(/\|/g, '_');
+}
+async function ensureDir(dir) {
+    if (!external_fs_existsSync(dir)) await mkdir(dir, {
+        recursive: true
+    });
+}
+async function readCache(cacheDir, key) {
+    try {
+        const fileName = keyToFileName(key);
+        const filePath = external_path_join(cacheDir, fileName);
+        if (!external_fs_existsSync(filePath)) return null;
+        const content = await readFile(filePath, 'utf-8');
+        return content;
+    } catch  {
+        return null;
+    }
+}
+async function writeCache(cacheDir, key, content) {
+    try {
+        await ensureDir(cacheDir);
+        const fileName = keyToFileName(key);
+        const filePath = external_path_join(cacheDir, fileName);
+        await writeFile(filePath, content, 'utf-8');
+    } catch  {}
+}
+const MIN_SUPPORTED_VERSION = '2.90.2';
+function getVersionCacheDir() {
+    return external_path_join(getCacheDir(), 'version');
+}
+function getVersionCacheKey(packageName, tag) {
+    return `${packageName}@${tag}`;
+}
+function getCurrentDate() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+async function fetchVersionFromRegistry(packageName, tag) {
+    const registries = [
+        `https://registry.npmmirror.com/${packageName}/${tag}`,
+        `https://registry.npmjs.org/${packageName}/${tag}`
+    ];
+    let lastError = null;
+    for (const url of registries)try {
+        const response = await fetch(url, {
+            headers: {
+                Accept: 'application/json'
+            }
+        });
+        if (!response.ok) throw new Error(`HTTP ${response.status}`);
+        const data = await response.json();
+        if (data && data.version) return data.version;
+        throw new Error('响应中没有 version 字段');
+    } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+    }
+    throw new Error(`无法获取 ${packageName}@${tag} 的版本号: ${lastError?.message}`);
+}
+async function resolveVersion(packageName, version) {
+    if (/^\d+\.\d+\.\d+/.test(version)) if (!lt(version, MIN_SUPPORTED_VERSION)) return version;
+    else version = 'latest';
+    const cacheDir = getVersionCacheDir();
+    const cacheKey = getVersionCacheKey(packageName, version);
+    const today = getCurrentDate();
+    const cachedContent = await readCache(cacheDir, cacheKey);
+    if (cachedContent) try {
+        const cached = JSON.parse(cachedContent);
+        if (cached.date === today) return cached.version;
+    } catch  {}
+    const resolvedVersion = await fetchVersionFromRegistry(packageName, version);
+    const cacheData = {
+        version: resolvedVersion,
+        date: today
+    };
+    await writeCache(cacheDir, cacheKey, JSON.stringify(cacheData));
+    return resolvedVersion;
+}
+const UNPKG_BASE_URL = 'https://unpkg.com';
+const NPMMIRROR_BASE_URL = 'https://registry.npmmirror.com';
+function getCacheKey(packageName, version, path) {
+    return `${packageName}@${version}/${path}`;
+}
+function flattenDirectoryStructure(item, result = []) {
+    result.push({
+        path: item.path,
+        type: item.type,
+        size: item.size
+    });
+    if (item.files && Array.isArray(item.files)) for (const file of item.files)flattenDirectoryStructure(file, result);
+    return result;
+}
+async function fetchNpmMirrorDirectoryRecursive(baseUrl, packageName, version, path, maxDepth = 10) {
+    if (maxDepth <= 0) return [];
+    const url = `${baseUrl}/${packageName}/${version}/files/${path}/?meta`;
+    const response = await fetch(url, {
+        headers: {
+            Accept: 'application/json'
+        }
+    });
+    if (!response.ok) throw new Error(`获取目录列表失败: ${response.status} ${response.statusText}`);
+    const contentType = response.headers.get('content-type') || '';
+    if (!contentType.includes('application/json')) throw new Error(`API 返回了非 JSON 格式: ${contentType}`);
+    const data = await response.json();
+    const normalizeType = (item)=>{
+        const path = item.path;
+        if (path.endsWith('/')) return {
+            path,
+            type: 'directory'
+        };
+        if (item.type && item.type.includes('/')) return {
+            path,
+            type: 'file'
+        };
+        if ('directory' === item.type) return {
+            path,
+            type: 'directory'
+        };
+        return {
+            path,
+            type: 'file'
+        };
+    };
+    const result = [];
+    if (data && 'object' == typeof data && 'files' in data && Array.isArray(data.files)) {
+        const promises = [];
+        for (const item of data.files){
+            const normalized = normalizeType(item);
+            result.push(normalized);
+            if ('directory' !== normalized.type || item.files && 0 !== item.files.length) {
+                if (item.files && Array.isArray(item.files) && item.files.length > 0) {
+                    const flattened = [];
+                    flattenDirectoryStructure(item, flattened);
+                    const subFiles = flattened.filter((f)=>f.path !== normalized.path).map(normalizeType);
+                    result.push(...subFiles);
+                }
+            } else {
+                const subPath = normalized.path.startsWith('/') ? normalized.path.slice(1) : normalized.path;
+                promises.push(fetchNpmMirrorDirectoryRecursive(baseUrl, packageName, version, subPath, maxDepth - 1).then((subFiles)=>subFiles.filter((f)=>f.path !== normalized.path)).catch(()=>[]));
+            }
+        }
+        if (promises.length > 0) {
+            const subResults = await Promise.all(promises);
+            for (const subFiles of subResults)result.push(...subFiles);
+        }
+    }
+    return result;
+}
+async function fetchDirectoryListFromSource(baseUrl, packageName, version, path, isNpmMirror = false) {
+    if (isNpmMirror) return fetchNpmMirrorDirectoryRecursive(baseUrl, packageName, version, path);
+    const url = `${baseUrl}/${packageName}@${version}/${path}/?meta`;
+    const response = await fetch(url, {
+        headers: {
+            Accept: 'application/json'
+        }
+    });
+    if (!response.ok) throw new Error(`获取目录列表失败: ${response.status} ${response.statusText}`);
+    const contentType = response.headers.get('content-type') || '';
+    if (!contentType.includes('application/json')) throw new Error(`API 返回了非 JSON 格式: ${contentType}`);
+    const data = await response.json();
+    const normalizeType = (item)=>{
+        const path = item.path;
+        if (path.endsWith('/')) return {
+            path,
+            type: 'directory'
+        };
+        if (item.type && item.type.includes('/')) return {
+            path,
+            type: 'file'
+        };
+        if ('directory' === item.type) return {
+            path,
+            type: 'directory'
+        };
+        return {
+            path,
+            type: 'file'
+        };
+    };
+    if (Array.isArray(data)) return data.map(normalizeType);
+    if (data && 'object' == typeof data && 'files' in data) {
+        const filesData = data;
+        if (Array.isArray(filesData.files)) return filesData.files.map(normalizeType);
+    }
+    if (data && 'object' == typeof data && 'path' in data) {
+        const singleItem = data;
+        if (singleItem.files && Array.isArray(singleItem.files)) {
+            const flattened = [];
+            flattenDirectoryStructure(singleItem, flattened);
+            return flattened.map(normalizeType);
+        }
+        return [
+            normalizeType(singleItem)
+        ];
+    }
+    throw new Error('无法解析目录列表数据格式');
+}
+async function fetchDirectoryList(packageName, version, path) {
+    const resolvedVersion = await resolveVersion(packageName, version);
+    const cacheKey = getCacheKey(packageName, resolvedVersion, path);
+    const cacheDir = file_cache_getDirectoryListCacheDir();
+    const cachedContent = await readCache(cacheDir, cacheKey);
+    if (cachedContent) try {
+        const cachedResult = JSON.parse(cachedContent);
+        return cachedResult;
+    } catch  {}
+    const unpkgPromise = fetchDirectoryListFromSource(UNPKG_BASE_URL, packageName, resolvedVersion, path, false);
+    const npmmirrorPromise = fetchDirectoryListFromSource(NPMMIRROR_BASE_URL, packageName, resolvedVersion, path, true);
+    const results = await Promise.allSettled([
+        unpkgPromise,
+        npmmirrorPromise
+    ]);
+    const successfulResults = [];
+    const errors = [];
+    if ('fulfilled' === results[0].status) successfulResults.push({
+        source: 'unpkg',
+        files: results[0].value
+    });
+    else errors.push(results[0].reason instanceof Error ? results[0].reason : new Error(String(results[0].reason)));
+    if ('fulfilled' === results[1].status) successfulResults.push({
+        source: 'npmmirror',
+        files: results[1].value
+    });
+    else errors.push(results[1].reason instanceof Error ? results[1].reason : new Error(String(results[1].reason)));
+    if (0 === successfulResults.length) throw new Error(`所有数据源都失败了: ${errors.map((e)=>e.message).join('; ')}`);
+    successfulResults.sort((a, b)=>{
+        if (b.files.length !== a.files.length) return b.files.length - a.files.length;
+        return 'unpkg' === a.source ? -1 : 1;
+    });
+    const result = successfulResults[0].files;
+    await writeCache(cacheDir, cacheKey, JSON.stringify(result));
+    return result;
+}
+async function getComponentList(version) {
+    const packageName = '@douyinfe/semi-ui';
+    const files = await fetchDirectoryList(packageName, version, 'lib');
+    if (!files || 0 === files.length) return [];
+    const componentSet = new Set();
+    for (const file of files){
+        const path = file.path;
+        const pathWithoutLib = path.replace(/^\/lib\//, '').replace(/^lib\//, '');
+        const parts = pathWithoutLib.split('/');
+        if (parts.length >= 2 && ('cjs' === parts[0] || 'es' === parts[0])) {
+            const componentName = parts[1];
+            if (componentName && 'lib' !== componentName) componentSet.add(componentName.toLowerCase());
+        } else if (parts.length >= 1) {
+            const componentName = parts[0];
+            if (componentName && 'lib' !== componentName && 'cjs' !== componentName && 'es' !== componentName) componentSet.add(componentName.toLowerCase());
+        }
+    }
+    return Array.from(componentSet).sort();
+}
+const fetch_file_content_UNPKG_BASE_URL = 'https://unpkg.com';
+const fetch_file_content_NPMMIRROR_BASE_URL = 'https://registry.npmmirror.com';
+function fetch_file_content_getCacheKey(packageName, version, filePath) {
+    return `${packageName}@${version}/${filePath}`;
+}
+async function fetchFileContentFromSource(baseUrl, packageName, version, filePath, isNpmMirror = false) {
+    const url = isNpmMirror ? `${baseUrl}/${packageName}/${version}/files/${filePath}` : `${baseUrl}/${packageName}@${version}/${filePath}`;
+    const response = await fetch(url, {
+        headers: {
+            Accept: 'text/plain, application/json, */*'
+        }
+    });
+    if (!response.ok) throw new Error(`获取文件失败: ${response.status} ${response.statusText}`);
+    const content = await response.text();
+    if (content.trim().startsWith('<!DOCTYPE html>') || content.includes('npmmirror 镜像站')) throw new Error('返回了 HTML 错误页面');
+    return content;
+}
+async function fetchFileContent(packageName, version, filePath) {
+    const resolvedVersion = await resolveVersion(packageName, version);
+    const cacheKey = fetch_file_content_getCacheKey(packageName, resolvedVersion, filePath);
+    const cacheDir = file_cache_getFileContentCacheDir();
+    const cachedContent = await readCache(cacheDir, cacheKey);
+    if (cachedContent) return cachedContent;
+    const unpkgPromise = fetchFileContentFromSource(fetch_file_content_UNPKG_BASE_URL, packageName, resolvedVersion, filePath, false);
+    const npmmirrorPromise = fetchFileContentFromSource(fetch_file_content_NPMMIRROR_BASE_URL, packageName, resolvedVersion, filePath, true);
+    const unpkgWithFallback = unpkgPromise.catch(()=>new Promise(()=>{}));
+    const npmmirrorWithFallback = npmmirrorPromise.catch(()=>new Promise(()=>{}));
+    const raceResult = await Promise.race([
+        unpkgWithFallback,
+        npmmirrorWithFallback
+    ]).catch(()=>null);
+    if (raceResult) {
+        await writeCache(cacheDir, cacheKey, raceResult);
+        return raceResult;
+    }
+    const results = await Promise.allSettled([
+        unpkgPromise,
+        npmmirrorPromise
+    ]);
+    const errors = [];
+    for (const result of results)if ('rejected' === result.status) errors.push(result.reason instanceof Error ? result.reason : new Error(String(result.reason)));
+    throw new Error(`所有数据源都失败了: ${errors.map((e)=>e.message).join('; ')}`);
+}
+async function getComponentDocuments(componentName, version = 'latest') {
+    const packageName = '@douyinfe/semi-ui';
+    const componentNameLower = componentName.toLowerCase();
+    const contentFiles = await fetchDirectoryList(packageName, version, 'content');
+    if (!contentFiles || 0 === contentFiles.length) return null;
+    const componentFiles = contentFiles.filter((file)=>{
+        if ('file' !== file.type) return false;
+        const path = file.path.toLowerCase();
+        const pathPattern = new RegExp(`/content/[^/]+/${componentNameLower}/index\\.md$`);
+        return pathPattern.test(path);
+    });
+    if (0 === componentFiles.length) return null;
+    const firstPath = componentFiles[0].path;
+    const pathParts = firstPath.split('/');
+    let categoryIndex = -1;
+    for(let i = 0; i < pathParts.length; i++)if ('content' === pathParts[i].toLowerCase()) {
+        categoryIndex = i + 1;
+        break;
+    }
+    if (-1 === categoryIndex || categoryIndex >= pathParts.length) return null;
+    const category = pathParts[categoryIndex];
+    const documentPromises = componentFiles.map(async (file)=>{
+        const filePath = file.path.startsWith('/') ? file.path.slice(1) : file.path;
+        const parts = file.path.split('/');
+        const fileName = parts[parts.length - 1];
+        try {
+            const content = await fetchFileContent(packageName, version, filePath);
+            return {
+                name: fileName,
+                path: file.path,
+                content: content
+            };
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                name: fileName,
+                path: file.path,
+                content: `获取文档内容失败: ${errorMessage}`
+            };
+        }
+    });
+    const documents = await Promise.all(documentPromises);
+    return {
+        category,
+        documents: documents.sort((a, b)=>a.name.localeCompare(b.name))
+    };
+}
+const CODE_BLOCK_REGEX = /```[\s\S]*?```/g;
+function extractCodeBlocks(content) {
+    const matches = content.match(CODE_BLOCK_REGEX);
+    return matches || [];
+}
+function replaceCodeBlocksWithPlaceholders(content, componentName) {
+    let index = 0;
+    return content.replace(CODE_BLOCK_REGEX, ()=>{
+        index++;
+        return `\`\`\`text
+[代码块 #${index} 已隐藏]
+要查看此代码，请使用 get_semi_code_block 工具，传入参数:
+- componentName: "${componentName}"
+- codeBlockIndex: ${index}
+\`\`\``;
+    });
+}
+const getSemiDocumentTool = {
+    name: 'get_semi_document',
+    description: '获取 Semi Design 组件文档、额外文档或组件列表。支持获取：1) 组件文档（如 Button、Input 等组件）；2) 额外文档，包括：advanced 分类下的文档（customize-theme、dark-mode、design-source、design-to-code）、ecosystem 分类下的文档（changelog、faq、react19、tailwind、update-to-v2、web-components）、experience 分类下的文档（accessibility、content-guidelines、internationalization）、start 分类下的文档（getting-started、introduction、overview）。注意：changelog 文档较大，需要使用分页格式获取，传入 changelog-1（第1页，最新内容）、changelog-2（第2页）等格式，每页300行。对于大型文档，代码块会被替换为占位符，需要使用 get_semi_code_block 工具获取具体代码',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            componentName: {
+                type: 'string',
+                description: '组件名称或文档名称。组件名称例如：Button、Input、Table 等；额外文档名称例如：customize-theme、dark-mode、design-source、design-to-code、changelog-1（changelog第1页，最新）、changelog-2（changelog第2页）等、faq、react19、tailwind、update-to-v2、web-components、accessibility、content-guidelines、internationalization、getting-started、introduction、overview 等。注意：changelog 必须使用分页格式（changelog-1、changelog-2等），不能直接传入 changelog。如果不提供，则返回组件列表'
+            },
+            version: {
+                type: 'string',
+                description: '版本号，例如 2.89.1。如果不提供，默认使用 latest'
+            }
+        },
+        required: []
+    }
+};
+const LARGE_DOCUMENT_THRESHOLD = 888;
+const CHANGELOG_PAGE_SIZE = 300;
+function generateDocumentUrl(docPath) {
+    const pathParts = docPath.split('/');
+    let contentIndex = -1;
+    for(let i = 0; i < pathParts.length; i++)if ('content' === pathParts[i].toLowerCase()) {
+        contentIndex = i;
+        break;
+    }
+    if (-1 === contentIndex || contentIndex + 3 >= pathParts.length) return '';
+    const category = pathParts[contentIndex + 1];
+    const componentName = pathParts[contentIndex + 2];
+    if (!category || !componentName) return '';
+    return `https://semi.design/zh-CN/${category}/${componentName}`;
+}
+function parseChangelogPage(componentName) {
+    const changelogMatch = componentName.match(/^(changelog)(?:-(\d+))?$/);
+    if (changelogMatch) {
+        const baseName = changelogMatch[1];
+        const pageStr = changelogMatch[2];
+        if (!pageStr) return {
+            isChangelog: true,
+            baseName
+        };
+        {
+            const page = parseInt(pageStr, 10);
+            return {
+                isChangelog: true,
+                page,
+                baseName
+            };
+        }
+    }
+    return {
+        isChangelog: false
+    };
+}
+function paginateChangelog(content, page) {
+    const lines = content.split('\n');
+    const totalLines = lines.length;
+    const totalPages = Math.ceil(totalLines / CHANGELOG_PAGE_SIZE);
+    const startIndex = (page - 1) * CHANGELOG_PAGE_SIZE;
+    const endIndex = Math.min(startIndex + CHANGELOG_PAGE_SIZE, totalLines);
+    const pageLines = lines.slice(startIndex, endIndex);
+    const pageContent = pageLines.join('\n');
+    return {
+        content: pageContent,
+        totalPages,
+        currentPage: page
+    };
+}
+async function handleGetSemiDocument(args) {
+    const componentName = args?.componentName;
+    const version = args?.version || 'latest';
+    try {
+        if (componentName) {
+            const changelogInfo = parseChangelogPage(componentName);
+            if (changelogInfo.isChangelog && !changelogInfo.page) return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `changelog 文档较大，需要使用分页方式获取。\n\n请使用以下格式获取：\n- changelog-1（第1页，最新内容）\n- changelog-2（第2页）\n- changelog-3（第3页）\n- ...\n\n页码从1开始，1为最新内容。`
+                    }
+                ]
+            };
+            const actualComponentName = changelogInfo.baseName || componentName;
+            const result = await getComponentDocuments(actualComponentName, version);
+            const allComponents = await getComponentList(version);
+            if (!result) return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `未找到组件 "${componentName}" 的文档 (版本 ${version})。\n\n可用组件列表：${allComponents.join(', ')}`
+                    }
+                ]
+            };
+            if (changelogInfo.isChangelog && changelogInfo.page) {
+                const page = changelogInfo.page;
+                if (0 === result.documents.length) return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `未找到 changelog 文档 (版本 ${version})`
+                        }
+                    ],
+                    isError: true
+                };
+                const doc = result.documents[0];
+                const paginated = paginateChangelog(doc.content, page);
+                if (page < 1 || page > paginated.totalPages) return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `页码 ${page} 超出范围。changelog 文档共有 ${paginated.totalPages} 页，请使用 changelog-1 到 changelog-${paginated.totalPages}。`
+                        }
+                    ],
+                    isError: true
+                };
+                const nextPageHint = page < paginated.totalPages ? `使用 changelog-${page + 1} 获取下一页` : '';
+                const prevPageHint = page > 1 ? `使用 changelog-${page - 1} 获取上一页` : '';
+                const pageHints = [
+                    nextPageHint,
+                    prevPageHint
+                ].filter(Boolean).join('，');
+                const header = `===== ${doc.name} (第 ${page}/${paginated.totalPages} 页) =====${pageHints ? `\n[提示: ${pageHints}]` : ''}`;
+                const footer = `\n\n[当前页: ${page}/${paginated.totalPages} | 总行数: ${doc.content.split('\n').length} | 每页: ${CHANGELOG_PAGE_SIZE} 行]`;
+                const url = generateDocumentUrl(doc.path);
+                const urlFooter = url ? `\n\n文档链接: ${url}` : '';
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `${header}\n\n${paginated.content}${footer}${urlFooter}`
+                        }
+                    ]
+                };
+            }
+            const documentsWithLines = result.documents.map((doc)=>({
+                    ...doc,
+                    lines: doc.content.split('\n').length
+                }));
+            const hasLargeDocument = documentsWithLines.some((doc)=>doc.lines > LARGE_DOCUMENT_THRESHOLD);
+            if (hasLargeDocument) {
+                const processedDocs = result.documents.map((doc)=>{
+                    const lines = doc.content.split('\n').length;
+                    if (lines > LARGE_DOCUMENT_THRESHOLD) {
+                        const codeBlocks = extractCodeBlocks(doc.content);
+                        const processedContent = replaceCodeBlocksWithPlaceholders(doc.content, componentName);
+                        return {
+                            ...doc,
+                            content: processedContent,
+                            codeBlockCount: codeBlocks.length,
+                            originalLines: lines
+                        };
+                    }
+                    return {
+                        ...doc,
+                        codeBlockCount: 0,
+                        originalLines: lines
+                    };
+                });
+                const docContents = processedDocs.map((doc)=>{
+                    let header = `===== ${doc.name} =====`;
+                    if (doc.codeBlockCount > 0) header += `\n[注意: 此文档原有 ${doc.originalLines} 行，包含 ${doc.codeBlockCount} 个代码块已被隐藏。使用 get_semi_code_block 工具查看具体代码]`;
+                    const url = generateDocumentUrl(doc.path);
+                    const urlFooter = url ? `\n\n文档链接: ${url}` : '';
+                    return `${header}\n\n${doc.content}${urlFooter}`;
+                }).join('\n\n');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: docContents
+                        }
+                    ]
+                };
+            }
+            const docContents = result.documents.map((doc)=>{
+                const url = generateDocumentUrl(doc.path);
+                const urlFooter = url ? `\n\n文档链接: ${url}` : '';
+                return `===== ${doc.name} =====\n\n${doc.content}${urlFooter}`;
+            }).join('\n\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: docContents
+                    }
+                ]
+            };
+        }
+        {
+            const components = await getComponentList(version);
+            if (0 === components.length) return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `未找到组件列表，请检查版本号 ${version} 是否正确`
+                    }
+                ],
+                isError: true
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Semi Design 组件列表 (版本 ${version})，共 ${components.length} 个组件：\n\n${components.join(', ')}`
+                    }
+                ]
+            };
+        }
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `获取文档失败: ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+const getSemiCodeBlockTool = {
+    name: 'get_semi_code_block',
+    description: '获取 Semi Design 组件文档中的特定代码块。当文档较大时，代码块会被隐藏，使用此工具可以获取指定序号的代码块内容',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            componentName: {
+                type: 'string',
+                description: '组件名称，例如 Button、Input、Form 等'
+            },
+            codeBlockIndex: {
+                type: 'number',
+                description: '代码块序号（从 1 开始）'
+            },
+            version: {
+                type: 'string',
+                description: '版本号，例如 2.89.1。如果不提供，默认使用 latest'
+            }
+        },
+        required: [
+            'componentName',
+            'codeBlockIndex'
+        ]
+    }
+};
+async function handleGetSemiCodeBlock(args) {
+    const componentName = args?.componentName;
+    const codeBlockIndex = args?.codeBlockIndex;
+    const version = args?.version || 'latest';
+    if (!componentName) return {
+        content: [
+            {
+                type: 'text',
+                text: '错误: 必须提供 componentName 参数'
+            }
+        ],
+        isError: true
+    };
+    if (null == codeBlockIndex) return {
+        content: [
+            {
+                type: 'text',
+                text: '错误: 必须提供 codeBlockIndex 参数'
+            }
+        ],
+        isError: true
+    };
+    if ('number' != typeof codeBlockIndex || codeBlockIndex < 1 || !Number.isInteger(codeBlockIndex)) return {
+        content: [
+            {
+                type: 'text',
+                text: '错误: codeBlockIndex 必须是大于等于 1 的整数'
+            }
+        ],
+        isError: true
+    };
+    try {
+        const result = await getComponentDocuments(componentName, version);
+        if (!result) return {
+            content: [
+                {
+                    type: 'text',
+                    text: `错误: 未找到组件 "${componentName}" 的文档 (版本 ${version})`
+                }
+            ],
+            isError: true
+        };
+        const allCodeBlocks = [];
+        for (const doc of result.documents){
+            const codeBlocks = extractCodeBlocks(doc.content);
+            codeBlocks.forEach((block, idx)=>{
+                allCodeBlocks.push({
+                    block,
+                    docName: doc.name,
+                    indexInDoc: idx + 1
+                });
+            });
+        }
+        if (0 === allCodeBlocks.length) return {
+            content: [
+                {
+                    type: 'text',
+                    text: `组件 "${componentName}" 的文档中没有代码块`
+                }
+            ]
+        };
+        if (codeBlockIndex > allCodeBlocks.length) return {
+            content: [
+                {
+                    type: 'text',
+                    text: `错误: 代码块序号 ${codeBlockIndex} 超出范围。组件 "${componentName}" 的文档中共有 ${allCodeBlocks.length} 个代码块 (序号范围: 1-${allCodeBlocks.length})`
+                }
+            ],
+            isError: true
+        };
+        const targetBlock = allCodeBlocks[codeBlockIndex - 1];
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `组件 ${componentName} 代码块 #${codeBlockIndex} (来自 ${targetBlock.docName}):\n\n${targetBlock.block}`
+                }
+            ]
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `获取代码块失败: ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+const FOUNDATION_PACKAGE = '@douyinfe/semi-foundation';
+const UI_PACKAGE = '@douyinfe/semi-ui';
+const EXCLUDE_DIRS = [
+    '/lib/',
+    '/es/',
+    '/dist/',
+    '/cjs/',
+    '/__test__/',
+    '/__tests__/',
+    '/_story/',
+    '/_stories/',
+    '/node_modules/'
+];
+function shouldExcludePath(filePath) {
+    for (const excludeDir of EXCLUDE_DIRS)if (filePath.includes(excludeDir)) return true;
+    return false;
+}
+function findComponentDirectory(directories, componentName) {
+    const normalizedName = componentName.toLowerCase();
+    for (const dir of directories){
+        if ('directory' !== dir.type) continue;
+        const dirPath = dir.path.replace(/^\//, '').replace(/\/$/, '');
+        const dirName = dirPath.split('/').pop() || '';
+        if (dirName.toLowerCase() === normalizedName) return dirPath;
+    }
+    return null;
+}
+async function getPackageComponentFiles(packageName, componentName, version) {
+    try {
+        const rootFiles = await fetchDirectoryList(packageName, version, '');
+        const componentDir = findComponentDirectory(rootFiles, componentName);
+        if (!componentDir) return [];
+        const componentDirPrefix = `/${componentDir}/`;
+        const files = [];
+        for (const file of rootFiles)if ('file' === file.type && file.path.startsWith(componentDirPrefix)) {
+            if (!shouldExcludePath(file.path)) {
+                const relativePath = file.path.startsWith('/') ? file.path.slice(1) : file.path;
+                files.push(`${packageName}/${relativePath}`);
+            }
+        }
+        return files;
+    } catch (error) {
+        console.error(`获取包 ${packageName} 的组件文件列表失败:`, error);
+        return [];
+    }
+}
+const getComponentFileListTool = {
+    name: 'get_component_file_list',
+    description: `获取 Semi Design 组件的所有文件路径列表。
+
+返回组件在 @douyinfe/semi-foundation 和 @douyinfe/semi-ui 中的所有文件路径。
+
+路径格式示例：
+- @douyinfe/semi-foundation/table/foundation.ts
+- @douyinfe/semi-ui/table/index.tsx
+- @douyinfe/semi-ui/table/Body/BaseRow.tsx
+
+使用场景：
+1. 先调用此工具获取组件文件列表
+2. 再使用 get_file_code 获取感兴趣的文件代码
+3. 如需查看具体函数实现，使用 get_function_code`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            componentName: {
+                type: 'string',
+                description: '组件名称，如 Table、DatePicker、Modal 等（大小写不敏感）'
+            },
+            version: {
+                type: 'string',
+                description: '版本号，默认为 "2.89.2-alpha.3"。注意：latest 版本可能只有编译后的代码'
+            }
+        },
+        required: [
+            'componentName'
+        ]
+    }
+};
+async function handleGetComponentFileList(args) {
+    const componentName = args?.componentName;
+    const version = args?.version || '2.89.2-alpha.3';
+    if (!componentName) return {
+        content: [
+            {
+                type: 'text',
+                text: '错误：请提供组件名称 (componentName)'
+            }
+        ],
+        isError: true
+    };
+    try {
+        const [foundationFiles, uiFiles] = await Promise.all([
+            getPackageComponentFiles(FOUNDATION_PACKAGE, componentName, version),
+            getPackageComponentFiles(UI_PACKAGE, componentName, version)
+        ]);
+        if (0 === foundationFiles.length && 0 === uiFiles.length) return {
+            content: [
+                {
+                    type: 'text',
+                    text: `未找到组件 "${componentName}" 的文件。请检查组件名称是否正确。`
+                }
+            ],
+            isError: true
+        };
+        const allFiles = [
+            ...foundationFiles,
+            ...uiFiles
+        ];
+        const stats = {
+            ts: allFiles.filter((f)=>f.endsWith('.ts') && !f.endsWith('.d.ts')).length,
+            tsx: allFiles.filter((f)=>f.endsWith('.tsx')).length,
+            dts: allFiles.filter((f)=>f.endsWith('.d.ts')).length,
+            scss: allFiles.filter((f)=>f.endsWith('.scss')).length,
+            other: allFiles.filter((f)=>!f.match(/\.(tsx?|d\.ts|scss)$/)).length
+        };
+        const output = [
+            `组件: ${componentName}`,
+            `版本: ${version}`,
+            `总文件数: ${allFiles.length}`,
+            "",
+            `文件类型统计:`,
+            `  .ts:   ${stats.ts}`,
+            `  .tsx:  ${stats.tsx}`,
+            `  .d.ts: ${stats.dts}`,
+            `  .scss: ${stats.scss}`,
+            `  其他:  ${stats.other}`,
+            "",
+            `===== 文件列表 =====`,
+            "",
+            ...allFiles,
+            "",
+            `提示: 使用 get_file_code 工具传入上述路径获取文件代码`
+        ];
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: output.join('\n')
+                }
+            ]
+        };
+    } catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `获取组件文件列表失败: ${error instanceof Error ? error.message : String(error)}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+function traverse(node, callback) {
+    if (!node) return;
+    if (Array.isArray(node)) {
+        for (const child of node)traverse(child, callback);
+        return;
+    }
+    callback(node);
+    const childKeys = [
+        'body',
+        'declarations',
+        'init',
+        'expression',
+        'left',
+        'right',
+        'properties',
+        'elements',
+        'argument',
+        'arguments',
+        'params',
+        'consequent',
+        'alternate',
+        'test',
+        'object',
+        'property',
+        'callee',
+        'value',
+        'key',
+        'computed',
+        'members',
+        'cases',
+        'discriminant',
+        'handler',
+        'block',
+        'finalizer',
+        'param',
+        'declaration',
+        'specifiers',
+        'source',
+        'exported',
+        'local',
+        'imported',
+        'superClass',
+        'decorators',
+        'typeAnnotation',
+        'returnType',
+        'typeParameters',
+        'implements',
+        'extends'
+    ];
+    for (const key of childKeys){
+        const child = node[key];
+        if (child && 'object' == typeof child) traverse(child, callback);
+    }
+}
+function extractFunctionsFromAST(ast, code) {
+    const functions = [];
+    traverse(ast, (node)=>{
+        let funcName;
+        let bodyStart;
+        let bodyEnd;
+        let funcStart;
+        let funcEnd;
+        switch(node.type){
+            case 'FunctionDeclaration':
+                if (node.id?.name && node.body && 'object' == typeof node.body && !Array.isArray(node.body)) {
+                    funcName = node.id.name;
+                    bodyStart = node.body.start;
+                    bodyEnd = node.body.end;
+                    funcStart = node.start;
+                    funcEnd = node.end;
+                }
+                break;
+            case 'FunctionExpression':
+                if (node.body && 'object' == typeof node.body && !Array.isArray(node.body)) {
+                    funcName = node.id?.name;
+                    bodyStart = node.body.start;
+                    bodyEnd = node.body.end;
+                    funcStart = node.start;
+                    funcEnd = node.end;
+                }
+                break;
+            case 'ArrowFunctionExpression':
+                if (node.body && 'object' == typeof node.body && !Array.isArray(node.body) && 'BlockStatement' === node.body.type) {
+                    bodyStart = node.body.start;
+                    bodyEnd = node.body.end;
+                    funcStart = node.start;
+                    funcEnd = node.end;
+                }
+                break;
+            case 'MethodDefinition':
+                if (node.key && node.value && 'object' == typeof node.value) {
+                    const keyNode = node.key;
+                    funcName = keyNode.name || keyNode.value;
+                    const valueNode = node.value;
+                    if (valueNode.body && 'object' == typeof valueNode.body && !Array.isArray(valueNode.body)) {
+                        bodyStart = valueNode.body.start;
+                        bodyEnd = valueNode.body.end;
+                        funcStart = node.start;
+                        funcEnd = node.end;
+                    }
+                }
+                break;
+            case 'PropertyDefinition':
+                if (node.key && node.value && 'object' == typeof node.value) {
+                    const keyNode = node.key;
+                    const valueNode = node.value;
+                    if ('ArrowFunctionExpression' === valueNode.type || 'FunctionExpression' === valueNode.type) {
+                        funcName = keyNode.name || keyNode.value;
+                        if (valueNode.body && 'object' == typeof valueNode.body && !Array.isArray(valueNode.body) && 'BlockStatement' === valueNode.body.type) {
+                            bodyStart = valueNode.body.start;
+                            bodyEnd = valueNode.body.end;
+                            funcStart = node.start;
+                            funcEnd = node.end;
+                        }
+                    }
+                }
+                break;
+            case 'Property':
+                if (node.key && node.value && 'object' == typeof node.value) {
+                    const keyNode = node.key;
+                    const valueNode = node.value;
+                    if ('FunctionExpression' === valueNode.type || 'ArrowFunctionExpression' === valueNode.type) {
+                        funcName = keyNode.name || keyNode.value;
+                        if (valueNode.body && 'object' == typeof valueNode.body && !Array.isArray(valueNode.body) && 'BlockStatement' === valueNode.body.type) {
+                            bodyStart = valueNode.body.start;
+                            bodyEnd = valueNode.body.end;
+                            funcStart = node.start;
+                            funcEnd = node.end;
+                        }
+                    }
+                }
+                break;
+        }
+        if (void 0 !== bodyStart && void 0 !== bodyEnd && void 0 !== funcStart && void 0 !== funcEnd) functions.push({
+            name: funcName || '<anonymous>',
+            bodyStart,
+            bodyEnd,
+            fullCode: code.slice(funcStart, funcEnd),
+            start: funcStart,
+            end: funcEnd
+        });
+    });
+    functions.sort((a, b)=>a.start - b.start);
+    return functions;
+}
+function extractVariableDeclarationFunctions(ast, code, existingFunctions) {
+    const existingStarts = new Set(existingFunctions.map((f)=>f.bodyStart));
+    traverse(ast, (node)=>{
+        if ('VariableDeclaration' === node.type && node.declarations) {
+            for (const decl of node.declarations)if ('VariableDeclarator' === decl.type && decl.id && decl.init) {
+                const idNode = decl.id;
+                const initNode = decl.init;
+                if (('ArrowFunctionExpression' === initNode.type || 'FunctionExpression' === initNode.type) && initNode.body && 'object' == typeof initNode.body && !Array.isArray(initNode.body) && 'BlockStatement' === initNode.body.type) {
+                    const bodyStart = initNode.body.start;
+                    for (const func of existingFunctions)if (func.bodyStart === bodyStart && '<anonymous>' === func.name) {
+                        func.name = idNode.name || '<anonymous>';
+                        break;
+                    }
+                    if (!existingStarts.has(bodyStart)) existingFunctions.push({
+                        name: idNode.name || '<anonymous>',
+                        bodyStart,
+                        bodyEnd: initNode.body.end,
+                        fullCode: code.slice(node.start, node.end),
+                        start: node.start,
+                        end: node.end
+                    });
+                }
+            }
+        }
+    });
+}
+function findAllFunctions(code, filename = 'code.tsx') {
+    try {
+        const result = parseSync(filename, code);
+        if (result.errors && result.errors.length > 0) console.warn('解析代码时有错误:', result.errors);
+        const ast = result.program;
+        const functions = extractFunctionsFromAST(ast, code);
+        extractVariableDeclarationFunctions(ast, code, functions);
+        functions.sort((a, b)=>a.start - b.start);
+        return functions;
+    } catch (error) {
+        console.error('解析代码失败:', error);
+        return [];
+    }
+}
+function removeFunctionBodies(code, filename = 'code.tsx') {
+    const functions = findAllFunctions(code, filename);
+    if (0 === functions.length) return code;
+    const sortedByBodyStart = [
+        ...functions
+    ].sort((a, b)=>b.bodyStart - a.bodyStart);
+    let result = code;
+    const replacedRanges = [];
+    for (const func of sortedByBodyStart){
+        const isNested = replacedRanges.some((range)=>func.bodyStart >= range.start && func.bodyEnd <= range.end);
+        if (isNested) continue;
+        const before = result.slice(0, func.bodyStart);
+        const after = result.slice(func.bodyEnd);
+        result = before + '{ ... }' + after;
+        replacedRanges.push({
+            start: func.bodyStart,
+            end: func.bodyEnd
+        });
+    }
+    return result;
+}
+function extractFunction(code, functionName, filename = 'code.tsx') {
+    const functions = findAllFunctions(code, filename);
+    const targetFunction = functions.find((f)=>f.name === functionName);
+    if (!targetFunction) return null;
+    return targetFunction.fullCode;
+}
+function getFunctionNames(code, filename = 'code.tsx') {
+    const functions = findAllFunctions(code, filename);
+    const names = functions.map((f)=>f.name).filter((name)=>'<anonymous>' !== name);
+    return Array.from(new Set(names));
+}
+function parseFilePath(fullPath) {
+    const match = fullPath.match(/^(@douyinfe\/semi-(?:foundation|ui))\/(.+)$/);
+    if (!match) return null;
+    return {
+        packageName: match[1],
+        filePath: match[2]
+    };
+}
+function isTypeScriptFile(filePath) {
+    return filePath.endsWith('.ts') || filePath.endsWith('.tsx');
+}
+const LINE_THRESHOLD = 500;
+const getFileCodeTool = {
+    name: 'get_file_code',
+    description: `获取 Semi Design 组件文件的代码内容。
+
+输入文件路径（从 get_component_file_list 工具获取），返回文件代码。
+
+默认行为：
+- .ts/.tsx 文件且行数 >= ${LINE_THRESHOLD}：函数体被替换为 "{ ... }"，只显示代码结构
+- .ts/.tsx 文件且行数 < ${LINE_THRESHOLD}：显示完整代码
+- 其他文件（.scss 等）：显示完整内容
+
+可通过 fullCode 参数强制获取完整代码（包含函数体）。
+
+路径格式示例：
+- @douyinfe/semi-foundation/table/foundation.ts
+- @douyinfe/semi-ui/table/index.tsx`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            filePath: {
+                type: 'string',
+                description: '文件完整路径，如 @douyinfe/semi-ui/table/index.tsx'
+            },
+            version: {
+                type: 'string',
+                description: '版本号，默认为 "2.89.2-alpha.3"'
+            },
+            fullCode: {
+                type: 'boolean',
+                description: '是否获取完整代码（包含函数体），默认为 false'
+            }
+        },
+        required: [
+            'filePath'
+        ]
+    }
+};
+async function handleGetFileCode(args) {
+    const filePath = args?.filePath;
+    const version = args?.version || '2.89.2-alpha.3';
+    const fullCode = args?.fullCode || false;
+    if (!filePath) return {
+        content: [
+            {
+                type: 'text',
+                text: '错误：请提供文件路径 (filePath)'
+            }
+        ],
+        isError: true
+    };
+    const parsed = parseFilePath(filePath);
+    if (!parsed) return {
+        content: [
+            {
+                type: 'text',
+                text: `错误：无效的文件路径格式。路径应为 @douyinfe/semi-foundation/xxx 或 @douyinfe/semi-ui/xxx 格式。\n\n提供的路径: ${filePath}`
+            }
+        ],
+        isError: true
+    };
+    try {
+        const content = await fetchFileContent(parsed.packageName, version, parsed.filePath);
+        const lineCount = content.split('\n').length;
+        let outputContent = content;
+        let processInfo = '';
+        const shouldFilterFunctionBodies = isTypeScriptFile(filePath) && !fullCode && lineCount >= LINE_THRESHOLD;
+        if (shouldFilterFunctionBodies) {
+            outputContent = removeFunctionBodies(content);
+            processInfo = '（代码较长，函数体已替换为 "{ ... }"，推荐使用 get_function_code 工具读取具体函数实现）';
+        }
+        const output = [
+            `文件: ${filePath}`,
+            `版本: ${version}`,
+            `行数: ${lineCount}`,
+            `大小: ${content.length} 字符`,
+            processInfo ? `处理: ${processInfo}` : '',
+            '',
+            '='.repeat(60),
+            '',
+            outputContent
+        ].filter(Boolean);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: output.join('\n')
+                }
+            ]
+        };
+    } catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `获取文件内容失败: ${error instanceof Error ? error.message : String(error)}\n\n文件路径: ${filePath}\n版本: ${version}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+function get_function_code_parseFilePath(fullPath) {
+    const match = fullPath.match(/^(@douyinfe\/semi-(?:foundation|ui))\/(.+)$/);
+    if (!match) return null;
+    return {
+        packageName: match[1],
+        filePath: match[2]
+    };
+}
+const getFunctionCodeTool = {
+    name: 'get_function_code',
+    description: `获取 Semi Design 组件文件中指定函数的完整实现。
+
+输入文件路径和函数名，返回函数的完整代码（包含函数体）。
+
+支持的函数类型：
+- 普通函数声明: function foo() {}
+- 箭头函数: const foo = () => {}
+- 类方法: class Foo { bar() {} }
+- getter/setter: get foo() {} / set foo() {}
+
+路径格式示例：
+- @douyinfe/semi-foundation/table/foundation.ts
+- @douyinfe/semi-ui/table/Table.tsx`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            filePath: {
+                type: 'string',
+                description: '文件完整路径，如 @douyinfe/semi-ui/table/Table.tsx'
+            },
+            functionName: {
+                type: 'string',
+                description: '函数名称，如 render、handleClick、adapter 等'
+            },
+            version: {
+                type: 'string',
+                description: '版本号，默认为 "2.89.2-alpha.3"'
+            }
+        },
+        required: [
+            'filePath',
+            'functionName'
+        ]
+    }
+};
+async function handleGetFunctionCode(args) {
+    const filePath = args?.filePath;
+    const functionName = args?.functionName;
+    const version = args?.version || '2.89.2-alpha.3';
+    if (!filePath) return {
+        content: [
+            {
+                type: 'text',
+                text: '错误：请提供文件路径 (filePath)'
+            }
+        ],
+        isError: true
+    };
+    if (!functionName) return {
+        content: [
+            {
+                type: 'text',
+                text: '错误：请提供函数名称 (functionName)'
+            }
+        ],
+        isError: true
+    };
+    const parsed = get_function_code_parseFilePath(filePath);
+    if (!parsed) return {
+        content: [
+            {
+                type: 'text',
+                text: `错误：无效的文件路径格式。路径应为 @douyinfe/semi-foundation/xxx 或 @douyinfe/semi-ui/xxx 格式。\n\n提供的路径: ${filePath}`
+            }
+        ],
+        isError: true
+    };
+    try {
+        const content = await fetchFileContent(parsed.packageName, version, parsed.filePath);
+        const functionCode = extractFunction(content, functionName);
+        if (!functionCode) {
+            const allFunctions = getFunctionNames(content);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `未找到函数 "${functionName}"`,
+                            '',
+                            `文件: ${filePath}`,
+                            `版本: ${version}`,
+                            '',
+                            `文件中可用的函数/方法 (共 ${allFunctions.length} 个):`,
+                            ...allFunctions.map((name)=>`  - ${name}`)
+                        ].join('\n')
+                    }
+                ],
+                isError: true
+            };
+        }
+        const output = [
+            `文件: ${filePath}`,
+            `函数: ${functionName}`,
+            `版本: ${version}`,
+            '',
+            '='.repeat(60),
+            '',
+            functionCode
+        ];
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: output.join('\n')
+                }
+            ]
+        };
+    } catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `获取函数代码失败: ${error instanceof Error ? error.message : String(error)}\n\n文件路径: ${filePath}\n函数名: ${functionName}\n版本: ${version}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+const tools = [
+    getSemiDocumentTool,
+    getSemiCodeBlockTool,
+    getComponentFileListTool,
+    getFileCodeTool,
+    getFunctionCodeTool
+];
+const toolHandlers = {
+    [getSemiDocumentTool.name]: handleGetSemiDocument,
+    [getSemiCodeBlockTool.name]: handleGetSemiCodeBlock,
+    [getComponentFileListTool.name]: handleGetComponentFileList,
+    [getFileCodeTool.name]: handleGetFileCode,
+    [getFunctionCodeTool.name]: handleGetFunctionCode
+};
+const server_filename = fileURLToPath(import.meta.url);
+const server_dirname = dirname(server_filename);
+function getPackageVersion() {
+    try {
+        const packageJsonPath = external_path_join(server_dirname, '../package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        return packageJson.version;
+    } catch  {
+        try {
+            const packageJsonPath = external_path_join(server_dirname, '../../package.json');
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            return packageJson.version;
+        } catch  {
+            return '1.0.0';
+        }
+    }
+}
+function createMCPServer() {
+    const version = getPackageVersion();
+    const server = new Server({
+        name: 'semi-mcp',
+        version
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {}
+        }
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async ()=>({
+            tools: tools
+        }));
+    server.setRequestHandler(CallToolRequestSchema, async (request)=>{
+        const { name, arguments: args } = request.params;
+        const handler = toolHandlers[name];
+        if (!handler) throw new Error(`未知的工具: ${name}`);
+        return handler(args || {});
+    });
+    server.setRequestHandler(ListResourcesRequestSchema, async ()=>({
+            resources: [
+                {
+                    uri: 'semi://components',
+                    name: 'Semi Components',
+                    description: 'Semi Design 组件列表',
+                    mimeType: 'application/json'
+                }
+            ]
+        }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request)=>{
+        const { uri } = request.params;
+        if ('semi://components' === uri || uri.startsWith('semi://components')) {
+            const version = 'latest';
+            try {
+                const components = await getComponentList(version);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                version,
+                                components,
+                                count: components.length,
+                                description: 'Semi Design 组件列表',
+                                note: '如需指定版本，请使用 get_semi_document 工具'
+                            }, null, 2)
+                        }
+                    ]
+                };
+            } catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                version,
+                                error: errorMessage,
+                                components: [],
+                                count: 0
+                            }, null, 2)
+                        }
+                    ]
+                };
+            }
+        }
+        throw new Error(`未知的资源 URI: ${uri}`);
+    });
+    return server;
+}
+async function main() {
+    const res = await axios.get("https://semi.design");
+    if ("1" === res.headers['x-user-internal']) {
+        console.log("Semi MCP Server (stdio) 启动失败: 字节跳动内部用户请使用内网 MCP 服务, 在字节云 MCP market 搜索 Semi");
+        console.log("Semi MCP Server (stdio) Load failed: ByteDance internal users please use the internal MCP service, search Semi in ByteCloud MCP market");
+        process.exit(1);
+    }
+    const server = createMCPServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error)=>{
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`Semi MCP Server (stdio) 启动失败: ${errorMessage}\n`);
+    process.exit(1);
+});