@douyinfe/semi-mcp 1.0.3 → 1.0.4

package/README.md

@@ -94,29 +94,48 @@ Get specific component documentation:
 
 **Response Format:**
 
+All responses are returned as plain text for AI-friendly consumption.
+
 When getting component list:
-```json
-{
-  "version": "2.89.2-alpha.3",
-  "components": ["button", "input", "select", ...],
-  "count": 70
-}
 ```
+Semi Design 组件列表 (版本 2.89.2-alpha.3)，共 70 个组件：
 
-When getting component documentation:
-```json
-{
-  "componentName": "button",
-  "version": "2.89.2-alpha.3",
-  "category": "basic",
-  "documents": ["index.md", "index-en-us.md"],
-  "count": 2,
-  "allComponents": ["button", "input", "select", ...],
-  "allComponentsCount": 70
-}
+button, input, select, table, ...
+```
+
+When getting small component documentation (< 888 lines):
 ```
+===== index.md =====
 
-**Note:** For large documents (over 888 lines), the tool will automatically save them to a temporary directory and return the file paths instead of content.
+---
+title: Button
+...
+---
+
+## Usage
+...
+
+===== index-en-US.md =====
+
+---
+title: Button
+...
+---
+
+## Usage
+...
+```
+
+When getting large component documentation (> 888 lines), the tool automatically saves to temp directory:
+```
+组件 Table (版本 2.89.2-alpha.3) 文档较大，已保存到临时目录。
+
+文档文件列表：
+  - /tmp/semi-docs-table-2.89.2-alpha.3-1234567890/index.md (6,055 行)
+  - /tmp/semi-docs-table-2.89.2-alpha.3-1234567890/index-en-US.md (5,660 行)
+
+请使用文件读取工具查看文档内容。
+```
 
 ### Resources
 

package/dist/index.js

@@ -280,15 +280,7 @@ async function handleGetSemiDocument(args) {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({
-                            componentName: componentName.toLowerCase(),
-                            version,
-                            error: '未找到组件文档',
-                            documents: [],
-                            count: 0,
-                            allComponents,
-                            allComponentsCount: allComponents.length
-                        }, null, 2)
+                        text: `未找到组件 "${componentName}" 的文档 (版本 ${version})。\n\n可用组件列表：${allComponents.join(', ')}`
                     }
                 ]
             };
@@ -306,68 +298,32 @@ async function handleGetSemiDocument(args) {
                 await mkdir(tempDir, {
                     recursive: true
                 });
-                const filePaths = [];
                 for (const doc of result.documents){
                     const filePath = join(tempDir, doc.name);
                     await writeFile(filePath, doc.content, 'utf-8');
-                    filePaths.push(filePath);
-                }
-                const largeDocs = documentsWithLines.filter((doc)=>doc.lines > 888);
-                let message = `文档已保存到临时目录: ${tempDir}\n请使用文件读取工具查看文档内容。`;
-                if (hasLargeDocument && !userExplicitlySetGetPath) {
-                    const largeDocNames = largeDocs.map((doc)=>`${doc.name} (${doc.lines.toLocaleString()} 行)`).join(', ');
-                    message = `文档已保存到临时目录: ${tempDir}\n注意：以下文档文件较大，已自动保存到临时目录：${largeDocNames}\n请使用文件读取工具查看文档内容。`;
-                } else if (hasLargeDocument) {
-                    const largeDocNames = largeDocs.map((doc)=>`${doc.name} (${doc.lines.toLocaleString()} 行)`).join(', ');
-                    message = `文档已保存到临时目录: ${tempDir}\n注意：以下文档文件较大：${largeDocNames}\n请使用文件读取工具查看文档内容。`;
                 }
+                const fileList = documentsWithLines.map((doc)=>`  - ${join(tempDir, doc.name)} (${doc.lines.toLocaleString()} 行)`).join('\n');
+                const message = `组件 ${componentName} (版本 ${version}) 文档较大，已保存到临时目录。
+
+文档文件列表：
+${fileList}
+
+请使用文件读取工具查看文档内容。`;
                 return {
                     content: [
                         {
                             type: 'text',
-                            text: JSON.stringify({
-                                componentName: componentName.toLowerCase(),
-                                version,
-                                category: result.category,
-                                tempDirectory: tempDir,
-                                files: documentsWithLines.map((doc)=>({
-                                        name: doc.name,
-                                        path: join(tempDir, doc.name),
-                                        contentLength: doc.content.length,
-                                        lines: doc.lines
-                                    })),
-                                count: result.documents.length,
-                                message,
-                                autoGetPath: hasLargeDocument && !userExplicitlySetGetPath,
-                                allComponents,
-                                allComponentsCount: allComponents.length
-                            }, null, 2)
+                            text: message
                         }
                     ]
                 };
             }
+            const docContents = result.documents.map((doc)=>`===== ${doc.name} =====\n\n${doc.content}`).join('\n\n');
             return {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({
-                            componentName: componentName.toLowerCase(),
-                            version,
-                            category: result.category,
-                            documents: result.documents.map((doc)=>({
-                                    name: doc.name,
-                                    path: doc.path,
-                                    contentLength: doc.content.length
-                                })),
-                            contents: result.documents.map((doc)=>({
-                                    name: doc.name,
-                                    path: doc.path,
-                                    content: doc.content
-                                })),
-                            count: result.documents.length,
-                            allComponents,
-                            allComponentsCount: allComponents.length
-                        }, null, 2)
+                        text: docContents
                     }
                 ]
             };
@@ -378,12 +334,7 @@ async function handleGetSemiDocument(args) {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({
-                            version,
-                            error: `未找到组件列表，请检查版本号 ${version} 是否正确`,
-                            components: [],
-                            count: 0
-                        }, null, 2)
+                        text: `未找到组件列表，请检查版本号 ${version} 是否正确`
                     }
                 ],
                 isError: true
@@ -392,11 +343,7 @@ async function handleGetSemiDocument(args) {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({
-                            version,
-                            components,
-                            count: components.length
-                        }, null, 2)
+                        text: `Semi Design 组件列表 (版本 ${version})，共 ${components.length} 个组件：\n\n${components.join(', ')}`
                     }
                 ]
             };
@@ -407,11 +354,7 @@ async function handleGetSemiDocument(args) {
             content: [
                 {
                     type: 'text',
-                    text: JSON.stringify({
-                        error: errorMessage,
-                        componentName: componentName?.toLowerCase(),
-                        version
-                    }, null, 2)
+                    text: `获取文档失败: ${errorMessage}`
                 }
             ],
             isError: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@douyinfe/semi-mcp",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Semi Design MCP Server - Model Context Protocol server for Semi Design components and documentation",
   "type": "module",
   "main": "./dist/index.js",