m8-mcp-server 1.0.0 → 1.0.2

package/dist/tools/index.js

@@ -0,0 +1,101 @@
+/**
+ * Tool Manager - 工具管理器
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 管理所有 MCP 工具的注册和调用
+ */
+import { searchDocsDefinition, executeSearchDocs } from './search-docs.js';
+import { getComponentInfoDefinition, executeGetComponentInfo } from './get-component-info.js';
+import { getApiInfoDefinition, executeGetApiInfo } from './get-api-info.js';
+import { getUtilInfoDefinition, executeGetUtilInfo } from './get-util-info.js';
+import { getCodingStandardDefinition, executeGetCodingStandard } from './get-coding-standard.js';
+import { generateCodeDefinition, executeGenerateCode } from './generate-code.js';
+import { recommendSolutionDefinition, executeRecommendSolution } from './recommend-solution.js';
+/**
+ * 工具管理器类
+ */
+export class ToolManager {
+    tools = new Map();
+    constructor() {
+        // 注册所有工具
+        this.registerTool(searchDocsDefinition, executeSearchDocs);
+        this.registerTool(getComponentInfoDefinition, executeGetComponentInfo);
+        this.registerTool(getApiInfoDefinition, executeGetApiInfo);
+        this.registerTool(getUtilInfoDefinition, executeGetUtilInfo);
+        this.registerTool(getCodingStandardDefinition, executeGetCodingStandard);
+        this.registerTool(generateCodeDefinition, executeGenerateCode);
+        this.registerTool(recommendSolutionDefinition, executeRecommendSolution);
+    }
+    /**
+     * 注册工具
+     * @param definition 工具定义
+     * @param executor 工具执行函数
+     */
+    registerTool(definition, executor) {
+        this.tools.set(definition.name, { definition, executor });
+    }
+    /**
+     * 获取所有工具定义
+     * @returns 工具定义数组
+     */
+    getToolDefinitions() {
+        return Array.from(this.tools.values()).map(t => t.definition);
+    }
+    /**
+     * 获取工具名称列表
+     * @returns 工具名称数组
+     */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * 检查工具是否存在
+     * @param name 工具名称
+     * @returns 是否存在
+     */
+    hasTool(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * 执行工具
+     * @param name 工具名称
+     * @param args 工具参数
+     * @returns 工具执行结果
+     */
+    async executeTool(name, args) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            const availableTools = this.getToolNames().join(', ');
+            return {
+                content: [{
+                        type: 'text',
+                        text: `工具 "${name}" 不存在。\n\n可用工具: ${availableTools}`
+                    }],
+                isError: true
+            };
+        }
+        try {
+            return await tool.executor(args);
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `工具执行失败: ${error instanceof Error ? error.message : '未知错误'}`
+                    }],
+                isError: true
+            };
+        }
+    }
+}
+// 导出单例
+export const toolManager = new ToolManager();
+// 导出所有工具模块
+export * from './search-docs.js';
+export * from './get-component-info.js';
+export * from './get-api-info.js';
+export * from './get-util-info.js';
+export * from './get-coding-standard.js';
+export * from './generate-code.js';
+export * from './recommend-solution.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAehG;;GAEG;AACH,MAAM,OAAO,WAAW;IACd,KAAK,GAAkC,IAAI,GAAG,EAAE,CAAC;IAEzD;QACE,SAAS;QACT,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;QAC3D,IAAI,CAAC,YAAY,CAAC,0BAA0B,EAAE,uBAAuB,CAAC,CAAC;QACvE,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;QAC3D,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAAC;QAC7D,IAAI,CAAC,YAAY,CAAC,2BAA2B,EAAE,wBAAwB,CAAC,CAAC;QACzE,IAAI,CAAC,YAAY,CAAC,sBAAsB,EAAE,mBAAmB,CAAC,CAAC;QAC/D,IAAI,CAAC,YAAY,CAAC,2BAA2B,EAAE,wBAAwB,CAAC,CAAC;IAC3E,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,UAA0B,EAAE,QAAsB;QAC7D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,IAA6B;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,OAAO,IAAI,mBAAmB,cAAc,EAAE;qBACrD,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,WAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE;qBACnE,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,OAAO;AACP,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAE7C,WAAW;AACX,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/dist/tools/recommend-solution.d.ts

@@ -0,0 +1,18 @@
+/**
+ * recommend_solution 工具实现
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 根据需求智能推荐合适的组件、API 或工具方法
+ */
+import type { ToolDefinition, ToolResult } from '../types/index.js';
+/**
+ * 工具定义
+ */
+export declare const recommendSolutionDefinition: ToolDefinition;
+/**
+ * 执行推荐解决方案工具
+ * @param args 工具参数
+ * @returns 工具执行结果
+ */
+export declare function executeRecommendSolution(args: Record<string, unknown>): Promise<ToolResult>;
+//# sourceMappingURL=recommend-solution.d.ts.map

package/dist/tools/recommend-solution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend-solution.d.ts","sourceRoot":"","sources":["../../src/tools/recommend-solution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAsB,MAAM,mBAAmB,CAAC;AAGxF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,cAkBzC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAiCjG"}

package/dist/tools/recommend-solution.js

@@ -0,0 +1,67 @@
+/**
+ * recommend_solution 工具实现
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 根据需求智能推荐合适的组件、API 或工具方法
+ */
+import { recommendationEngine } from '../recommend/index.js';
+/**
+ * 工具定义
+ */
+export const recommendSolutionDefinition = {
+    name: 'recommend_solution',
+    description: '根据需求智能推荐合适的组件、API 或工具方法，优先推荐 EJS 原生 API。',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            requirement: {
+                type: 'string',
+                description: '需求描述'
+            },
+            type: {
+                type: 'string',
+                enum: ['ui', 'data', 'native', 'general'],
+                description: '需求类型（可选）'
+            }
+        },
+        required: ['requirement']
+    }
+};
+/**
+ * 执行推荐解决方案工具
+ * @param args 工具参数
+ * @returns 工具执行结果
+ */
+export async function executeRecommendSolution(args) {
+    try {
+        const requirement = args.requirement;
+        const type = args.type;
+        if (!requirement || requirement.trim().length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: '错误：需求描述不能为空'
+                    }],
+                isError: true
+            };
+        }
+        const recommendations = recommendationEngine.recommend(requirement, type);
+        const result = recommendationEngine.formatRecommendations(recommendations);
+        return {
+            content: [{
+                    type: 'text',
+                    text: result
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `推荐失败: ${error instanceof Error ? error.message : '未知错误'}`
+                }],
+            isError: true
+        };
+    }
+}
+//# sourceMappingURL=recommend-solution.js.map

package/dist/tools/recommend-solution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend-solution.js","sourceRoot":"","sources":["../../src/tools/recommend-solution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAmB;IACzD,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,0CAA0C;IACvD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,MAAM;aACpB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACzC,WAAW,EAAE,UAAU;aACxB;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAA6B;IAC1E,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,WAAqB,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAsC,CAAC;QAEzD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,aAAa;qBACpB,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,oBAAoB,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAE3E,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE;iBACjE,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/search-docs.d.ts

@@ -0,0 +1,18 @@
+/**
+ * search_docs 工具实现
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 搜索 M8 框架文档
+ */
+import type { ToolDefinition, ToolResult } from '../types/index.js';
+/**
+ * 工具定义
+ */
+export declare const searchDocsDefinition: ToolDefinition;
+/**
+ * 执行搜索文档工具
+ * @param args 工具参数
+ * @returns 工具执行结果
+ */
+export declare function executeSearchDocs(args: Record<string, unknown>): Promise<ToolResult>;
+//# sourceMappingURL=search-docs.d.ts.map

package/dist/tools/search-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-docs.d.ts","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AAGtF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAsBlC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC1F"}

package/dist/tools/search-docs.js

@@ -0,0 +1,71 @@
+/**
+ * search_docs 工具实现
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 搜索 M8 框架文档
+ */
+import { documentManager } from '../docs/index.js';
+/**
+ * 工具定义
+ */
+export const searchDocsDefinition = {
+    name: 'search_docs',
+    description: '搜索 M8 框架文档，支持关键词搜索和分类过滤。可搜索 EJS API、UI 组件、Util 工具、编码规范等文档。',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: '搜索关键词'
+            },
+            category: {
+                type: 'string',
+                enum: ['ejs-api', 'ui-component', 'util-tool', 'typical-case', 'standard'],
+                description: '文档分类过滤（可选）'
+            },
+            limit: {
+                type: 'number',
+                description: '最大返回数量，默认 10'
+            }
+        },
+        required: ['query']
+    }
+};
+/**
+ * 执行搜索文档工具
+ * @param args 工具参数
+ * @returns 工具执行结果
+ */
+export async function executeSearchDocs(args) {
+    try {
+        const query = args.query;
+        const category = args.category;
+        const limit = args.limit || 10;
+        if (!query || query.trim().length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: '错误：搜索关键词不能为空'
+                    }],
+                isError: true
+            };
+        }
+        const result = documentManager.searchDocsFormatted(query, { category, limit });
+        return {
+            content: [{
+                    type: 'text',
+                    text: result
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `搜索失败: ${error instanceof Error ? error.message : '未知错误'}`
+                }],
+            isError: true
+        };
+    }
+}
+//# sourceMappingURL=search-docs.js.map

package/dist/tools/search-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-docs.js","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,4DAA4D;IACzE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,OAAO;aACrB;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,CAAC;gBAC1E,WAAW,EAAE,YAAY;aAC1B;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAA6B;IACnE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAwC,CAAC;QAC/D,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,EAAE,CAAC;QAE3C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,cAAc;qBACrB,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC,mBAAmB,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAE/E,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE;iBACjE,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,285 @@
+/**
+ * M8 MCP Server 核心类型定义
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 定义 MCP Server 所需的所有接口和类型
+ */
+/**
+ * MCP 工具定义
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * MCP 工具执行结果
+ */
+export interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * 文档分类类型
+ */
+export type DocumentCategory = 'ejs-api' | 'ui-component' | 'util-tool' | 'typical-case' | 'standard';
+/**
+ * 搜索选项
+ */
+export interface SearchOptions {
+    category?: DocumentCategory;
+    limit?: number;
+}
+/**
+ * 搜索结果
+ */
+export interface SearchResult {
+    title: string;
+    category: DocumentCategory;
+    description: string;
+    content: string;
+}
+/**
+ * Props 定义
+ */
+export interface PropDefinition {
+    name: string;
+    type: string;
+    default?: string;
+    required: boolean;
+    description: string;
+}
+/**
+ * Events 定义
+ */
+export interface EventDefinition {
+    name: string;
+    parameters: string;
+    description: string;
+}
+/**
+ * Slots 定义
+ */
+export interface SlotDefinition {
+    name: string;
+    description: string;
+}
+/**
+ * 代码示例
+ */
+export interface CodeExample {
+    title: string;
+    code: string;
+    description?: string;
+}
+/**
+ * 组件信息
+ */
+export interface ComponentInfo {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    props: PropDefinition[];
+    events: EventDefinition[];
+    slots?: SlotDefinition[];
+    examples: {
+        vue2?: CodeExample[];
+        vue3?: CodeExample[];
+    };
+}
+/**
+ * API 方法定义
+ */
+export interface ApiMethod {
+    name: string;
+    description: string;
+    parameters: Array<{
+        name: string;
+        type: string;
+        required: boolean;
+        description: string;
+    }>;
+    returnValue: {
+        type: string;
+        description: string;
+    };
+    platformSupport: {
+        ios: boolean;
+        android: boolean;
+        h5: boolean;
+    };
+    examples: CodeExample[];
+}
+/**
+ * API 模块信息
+ */
+export interface ApiInfo {
+    module: string;
+    description: string;
+    methods: ApiMethod[];
+}
+/**
+ * Util 方法定义
+ */
+export interface UtilMethod {
+    name: string;
+    description: string;
+    parameters: Array<{
+        name: string;
+        type: string;
+        required: boolean;
+        description: string;
+    }>;
+    returnValue: {
+        type: string;
+        description: string;
+    };
+    examples: CodeExample[];
+}
+/**
+ * Util 分类信息
+ */
+export interface UtilInfo {
+    category: string;
+    title: string;
+    description: string;
+    methods: UtilMethod[];
+}
+/**
+ * 编码规范类型
+ */
+export type StandardType = 'css' | 'javascript' | 'vue' | 'project-structure' | 'all';
+/**
+ * 编码规则
+ */
+export interface CodingRule {
+    id: string;
+    title: string;
+    description: string;
+    correctExample?: string;
+    incorrectExample?: string;
+}
+/**
+ * 编码规范
+ */
+export interface CodingStandard {
+    id: string;
+    category: Exclude<StandardType, 'all'>;
+    title: string;
+    description?: string;
+    rules: CodingRule[];
+}
+/**
+ * 单一代码生成类型
+ */
+export type GenerateType = 'vue-component' | 'javascript' | 'scss' | 'api-call' | 'full-page';
+/**
+ * 可组合的代码类型（用于多选）
+ */
+export type ComposableCodeType = 'vue-component' | 'javascript' | 'scss' | 'api-call';
+/**
+ * 代码生成选项
+ */
+export interface GenerateOptions {
+    type: GenerateType | ComposableCodeType[];
+    requirement: string;
+    vueVersion?: 2 | 3;
+    components?: string[];
+}
+/**
+ * 多文件生成结果
+ */
+export interface MultiFileGeneratedCode {
+    files: Array<{
+        type: ComposableCodeType;
+        code: string;
+        language: string;
+        filename: string;
+    }>;
+    explanation: string;
+}
+/**
+ * 文件头选项
+ */
+export interface HeaderOptions {
+    author?: string;
+    description: string;
+    version?: string;
+}
+/**
+ * 生成的代码
+ */
+export interface GeneratedCode {
+    code: string;
+    language: string;
+    explanation: string;
+}
+/**
+ * 推荐类型
+ */
+export type RecommendationType = 'ui' | 'data' | 'native' | 'general';
+/**
+ * 推荐结果类型
+ */
+export type RecommendationResultType = 'ejs-api' | 'ui-component' | 'util-method';
+/**
+ * 推荐结果
+ */
+export interface Recommendation {
+    type: RecommendationResultType;
+    name: string;
+    description: string;
+    reason: string;
+    priority: number;
+    usage: string;
+}
+/**
+ * UI 组件文档
+ */
+export interface UIComponentDoc extends ComponentInfo {
+}
+/**
+ * API 文档
+ */
+export interface ApiDoc extends ApiInfo {
+}
+/**
+ * Util 文档
+ */
+export interface UtilDoc extends UtilInfo {
+}
+/**
+ * 编码规范文档
+ */
+export interface CodingStandardDoc extends CodingStandard {
+}
+/**
+ * 典型案例文档
+ */
+export interface CaseDoc {
+    id: string;
+    title: string;
+    description: string;
+    category: 'list-detail' | 'form-submit';
+    vueVersion: 2 | 3;
+    code: string;
+}
+/**
+ * 文档索引
+ */
+export interface DocumentIndex {
+    components: Map<string, UIComponentDoc>;
+    apis: Map<string, ApiDoc>;
+    utils: Map<string, UtilDoc>;
+    standards: Map<string, CodingStandardDoc>;
+    cases: CaseDoc[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * M8 MCP Server 核心类型定义
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 定义 MCP Server 所需的所有接口和类型
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,43 +1,44 @@
 {
   "name": "m8-mcp-server",
-  "version": "1.0.0",
-  "description": "MCP server for M8 framework and EJS API documentation",
+  "version": "1.0.2",
+  "description": "M8 移动前端跨端框架 MCP Server - 提供文档查询、智能推荐和代码生成服务",
   "main": "dist/index.js",
   "bin": {
-    "m8-mcp": "./bin/m8-mcp.js"
+    "m8-mcp-server": "./dist/cli.js"
   },
-  "files": [
-    "dist",
-    "bin",
-    "README.md"
-  ],
+  "type": "module",
   "scripts": {
-    "build": "tsc && npm run copy-data && npm run obfuscate",
-    "copy-data": "node -e \"const fs=require('fs'); const path=require('path'); const src=path.join('src','data'); const dest=path.join('dist','data'); fs.cpSync(src, dest, {recursive: true});\"",
-    "obfuscate": "javascript-obfuscator ./dist --output ./dist --compact true --self-defending true",
-    "start": "node dist/index.js",
-    "dev": "ts-node src/index.ts",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "mcp",
     "m8",
-    "ejs",
-    "documentation"
+    "mobile",
+    "frontend",
+    "vue",
+    "code-generation"
   ],
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "resources"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.6.0",
-    "fast-glob": "^3.3.2",
-    "fuse.js": "^7.0.0",
-    "gray-matter": "^4.0.3",
-    "zod": "^3.23.8"
+    "@modelcontextprotocol/sdk": "^1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^20.12.7",
-    "javascript-obfuscator": "^4.1.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.4.5"
+    "@types/node": "^20.10.0",
+    "fast-check": "^3.15.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
   }
 }