@zhin.js/mcp 1.0.0

package/lib/handlers.js

@@ -0,0 +1,374 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { useApp } from "zhin.js";
+const app = useApp();
+/**
+ * 创建插件文件
+ */
+export async function createPlugin(args) {
+    const { name, description, features = [], directory = "src/plugins" } = args;
+    const pluginCode = generatePluginCode(name, description, features);
+    const filename = `${name}.ts`;
+    const fullPath = path.join(process.cwd(), directory, filename);
+    try {
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        await fs.writeFile(fullPath, pluginCode, "utf-8");
+        return `✅ 插件 ${name} 已创建: ${fullPath}`;
+    }
+    catch (error) {
+        throw new Error(`创建插件失败: ${error.message}`);
+    }
+}
+function generatePluginCode(name, description, features) {
+    const imports = ["usePlugin"];
+    if (features.includes("command")) {
+        imports.push("addCommand", "MessageCommand");
+    }
+    if (features.includes("middleware")) {
+        imports.push("addMiddleware");
+    }
+    if (features.includes("component")) {
+        imports.push("addComponent", "defineComponent");
+    }
+    if (features.includes("context")) {
+        imports.push("useContext");
+    }
+    if (features.includes("database")) {
+        imports.push("defineModel", "onDatabaseReady");
+    }
+    let result = `/**
+ * ${description}
+ * @name ${name}
+ */
+import { ${imports.join(", ")} } from "zhin.js";
+
+const plugin = usePlugin();
+plugin.logger.info("插件 ${name} 已加载");
+
+`;
+    if (features.includes("command")) {
+        result += `// 示例命令
+addCommand(
+  new MessageCommand("${name} <content:text>")
+    .description("${description}")
+    .action(async (message, result) => {
+      const content = result.params.content;
+      plugin.logger.info(\`收到命令: \${content}\`);
+      return \`你说: \${content}\`;
+    })
+);
+
+`;
+    }
+    if (features.includes("middleware")) {
+        result += `// 示例中间件
+addMiddleware(async (message, next) => {
+  plugin.logger.info(\`消息来自: \${message.$sender.name}\`);
+  await next();
+});
+
+`;
+    }
+    if (features.includes("component")) {
+        result += `// 示例组件
+const MyComponent = defineComponent({
+  name: "my-comp",
+  props: {
+    title: String,
+    content: String,
+  },
+  render(props) {
+    return \`【\${props.title}】\${props.content}\`;
+  },
+});
+
+addComponent(MyComponent);
+
+`;
+    }
+    if (features.includes("database")) {
+        result += `// 示例数据模型
+declare module "@zhin.js/types" {
+  interface Models {
+    ${name}_data: {
+      id?: number;
+      name: string;
+      created_at?: Date;
+    };
+  }
+}
+
+defineModel("${name}_data", {
+  name: { type: "text", nullable: false },
+  created_at: { type: "timestamp", default: () => new Date() },
+});
+
+onDatabaseReady(async (db) => {
+  const model = db.model("${name}_data");
+  plugin.logger.info("数据库已就绪");
+});
+
+`;
+    }
+    return result;
+}
+/**
+ * 生成命令代码
+ */
+export function createCommandCode(args) {
+    const { pattern, description, hasPermission = false } = args;
+    let code = `import { addCommand, MessageCommand } from "zhin.js";
+
+addCommand(
+  new MessageCommand("${pattern}")
+    .description("${description}")`;
+    if (hasPermission) {
+        code += `
+    .permit((message) => {
+      // 权限检查逻辑
+      return message.$sender.role === "admin";
+    })`;
+    }
+    code += `
+    .action(async (message, result) => {
+      // 命令处理逻辑
+      const args = result.params;
+      return "处理结果";
+    })
+);
+`;
+    return code;
+}
+/**
+ * 生成组件代码
+ */
+export function createComponentCode(args) {
+    const { name, props, usesJsx = false } = args;
+    const propsObj = Object.entries(props)
+        .map(([key, type]) => `    ${key}: ${type},`)
+        .join("\n");
+    if (usesJsx) {
+        return `import { defineComponent } from "zhin.js";
+
+const ${name} = defineComponent({
+  name: "${name}",
+  props: {
+${propsObj}
+  },
+  render(props) {
+    return (
+      <text>
+        {/* 在这里使用 props 渲染内容 */}
+      </text>
+    );
+  },
+});
+
+export default ${name};
+`;
+    }
+    return `import { defineComponent } from "zhin.js";
+
+const ${name} = defineComponent({
+  name: "${name}",
+  props: {
+${propsObj}
+  },
+  render(props) {
+    return \`\${props.title}: \${props.content}\`;
+  },
+});
+
+export default ${name};
+`;
+}
+/**
+ * 查询插件信息
+ */
+export function queryPlugin(args) {
+    const { pluginName } = args;
+    const targetPlugin = app.findPluginByName(pluginName);
+    if (!targetPlugin) {
+        throw new Error(`插件 ${pluginName} 不存在`);
+    }
+    return {
+        name: targetPlugin.name,
+        filename: targetPlugin.filename,
+        status: targetPlugin.mounted ? "active" : "inactive",
+        commands: targetPlugin.commands.map((cmd) => ({
+            pattern: cmd.pattern,
+            description: cmd.description || "无描述",
+        })),
+        components: Array.from(targetPlugin.components.keys()),
+        middlewares: targetPlugin.middlewares.length,
+        contexts: Array.from(targetPlugin.contexts.keys()),
+        crons: targetPlugin.crons.length,
+        models: Array.from(targetPlugin.definitions.keys()),
+    };
+}
+/**
+ * 列出所有插件
+ */
+export function listPlugins() {
+    return app.dependencyList.map((dep) => ({
+        name: dep.name,
+        status: dep.mounted ? "active" : "inactive",
+        commandCount: dep.commands.length,
+        componentCount: dep.components.size,
+    }));
+}
+/**
+ * 生成适配器代码
+ */
+export function createAdapterCode(args) {
+    const { name, description, hasWebhook = false } = args;
+    const className = name
+        .split("-")
+        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+        .join("");
+    let code = `/**
+ * ${description}
+ */
+import {
+  Bot,
+  Adapter,
+  registerAdapter,
+  Message,
+  SendOptions,
+  segment,
+  usePlugin,
+} from "zhin.js";
+
+declare module "@zhin.js/types" {
+  interface RegisteredAdapters {
+    "${name}": Adapter<${className}Bot>;
+  }
+}
+
+export interface ${className}Config extends Bot.Config {
+  context: "${name}";
+  name: string;
+  apiKey?: string;
+}
+
+export class ${className}Bot implements Bot<any, ${className}Config> {
+  $config: ${className}Config;
+  $connected: boolean = false;
+
+  constructor(config: ${className}Config) {
+    this.$config = config;
+  }
+
+  async $connect(): Promise<void> {
+    this.$connected = true;
+  }
+
+  async $disconnect(): Promise<void> {
+    this.$connected = false;
+  }
+
+  $formatMessage(raw: any): Message<any> {
+    return Message.from({
+      id: raw.id,
+      type: "private",
+      content: raw.text,
+      $sender: {
+        id: raw.userId,
+        name: raw.userName,
+      },
+      $reply: async (content) => {
+        return await this.$sendMessage({
+          context: this.$config.context,
+          bot: this.$config.name,
+          id: raw.userId,
+          type: "private",
+          content,
+        });
+      },
+    });
+  }
+
+  async $sendMessage(options: SendOptions): Promise<string> {
+    return "message-id";
+  }
+
+  async $recallMessage(id: string): Promise<void> {
+    // 实现消息撤回逻辑
+  }
+}
+
+`;
+    if (hasWebhook) {
+        code += `import { useContext } from "zhin.js";
+
+useContext("router", (router) => {
+  registerAdapter(
+    new Adapter("${name}", (config: ${className}Config) => {
+      const bot = new ${className}Bot(config);
+      
+      router.post("/webhook/${name}", async (ctx) => {
+        const raw = ctx.request.body;
+        const message = bot.$formatMessage(raw);
+        bot.emit?.("message", message);
+        ctx.body = { success: true };
+      });
+      
+      return bot;
+    })
+  );
+});
+`;
+    }
+    else {
+        code += `registerAdapter(
+  new Adapter("${name}", (config: ${className}Config) => new ${className}Bot(config))
+);
+`;
+    }
+    return code;
+}
+/**
+ * 生成数据库模型代码
+ */
+export function createModelCode(args) {
+    const { name, fields } = args;
+    const fieldTypes = [];
+    const fieldDefs = [];
+    for (const [key, value] of Object.entries(fields)) {
+        const typeDef = typeof value === "string" ? value : value.type;
+        fieldTypes.push(`    ${key}${value.nullable !== false ? "?" : ""}: ${getTypeScriptType(typeDef)};`);
+        fieldDefs.push(`    ${key}: ${JSON.stringify(value)},`);
+    }
+    return `import { defineModel, onDatabaseReady } from "zhin.js";
+
+declare module "@zhin.js/types" {
+  interface Models {
+    ${name}: {
+${fieldTypes.join("\n")}
+    };
+  }
+}
+
+defineModel("${name}", {
+${fieldDefs.join("\n")}
+});
+
+onDatabaseReady(async (db) => {
+  const model = db.model("${name}");
+  // 在这里使用模型
+});
+`;
+}
+function getTypeScriptType(dbType) {
+    const typeMap = {
+        text: "string",
+        integer: "number",
+        real: "number",
+        boolean: "boolean",
+        json: "any",
+        timestamp: "Date",
+        date: "Date",
+    };
+    return typeMap[dbType] || "any";
+}
+//# sourceMappingURL=handlers.js.map

package/lib/handlers.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare module "@zhin.js/types" {
+    interface GlobalContext {
+        mcpServer: McpServer;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,aAAa;QACrB,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

package/lib/index.js

@@ -0,0 +1,88 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { register, usePlugin, defineSchema, Schema, useContext } from "zhin.js";
+import { registerTools } from "./tools.js";
+import { registerResources } from "./resources.js";
+import { registerPrompts } from "./prompts.js";
+const plugin = usePlugin();
+// 配置 Schema
+const schema = defineSchema(Schema.object({
+    enabled: Schema.boolean("enabled")
+        .default(true)
+        .description("是否启用 MCP Server"),
+    path: Schema.string("path")
+        .default("/mcp")
+        .description("HTTP 端点路径"),
+}));
+const config = schema(plugin.config, "mcp");
+// ============================================================================
+// 创建 MCP Server
+// ============================================================================
+function createMCPServer() {
+    const server = new McpServer({
+        name: "zhin-mcp-server",
+        version: "1.0.0",
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {},
+        },
+    });
+    // 注册所有工具、资源和提示词
+    registerTools(server);
+    registerResources(server);
+    registerPrompts(server);
+    return server;
+}
+// ============================================================================
+// 注册 Context 并启动服务
+// ============================================================================
+let mcpServer;
+let cleanup;
+register({
+    name: "mcpServer",
+    description: "MCP Server for Zhin development",
+    async mounted(p) {
+        if (!config.enabled) {
+            p.logger.info("MCP Server is disabled");
+            return null;
+        }
+        mcpServer = createMCPServer();
+        // HTTP Stream 传输
+        useContext("router", (router) => {
+            const mcpPath = config.path || "/mcp";
+            // 创建 StreamableHTTPServerTransport (无状态模式)
+            const httpTransport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined, // 无状态模式
+            });
+            // 连接 transport
+            mcpServer.connect(httpTransport).then(() => {
+                p.logger.info(`✅ MCP Server started at ${mcpPath}`);
+            }).catch((err) => {
+                p.logger.error("Failed to connect HTTP transport:", err);
+            });
+            // 处理 GET 和 POST 请求
+            router.get(mcpPath, async (ctx) => {
+                await httpTransport.handleRequest(ctx.req, ctx.res);
+            });
+            router.post(mcpPath, async (ctx) => {
+                await httpTransport.handleRequest(ctx.req, ctx.res, ctx.request.body);
+            });
+            cleanup = () => {
+                httpTransport.close();
+                p.logger.info("MCP Server HTTP transport closed");
+            };
+        });
+        return mcpServer;
+    },
+    async dispose() {
+        if (mcpServer) {
+            await mcpServer.close();
+        }
+        if (cleanup) {
+            cleanup();
+        }
+    },
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/prompts.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 注册所有 MCP 提示词
+ */
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/lib/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QAiEhD"}

package/lib/prompts.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+/**
+ * 注册所有 MCP 提示词
+ */
+export function registerPrompts(server) {
+    server.registerPrompt("create-plugin-workflow", {
+        description: "创建 Zhin 插件的完整工作流程指导",
+        argsSchema: {
+            feature_type: z.string().describe("插件功能类型 (command/middleware/component/adapter)"),
+        },
+    }, async (args) => ({
+        description: `创建 ${args.feature_type} 类型的 Zhin 插件`,
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `我想创建一个 ${args.feature_type} 类型的 Zhin 插件，请指导我完整的开发流程。`,
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("debug-plugin", {
+        description: "调试 Zhin 插件的步骤和技巧",
+        argsSchema: {
+            error_message: z.string().optional().describe("错误消息"),
+        },
+    }, async (args) => ({
+        description: "调试 Zhin 插件",
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: args.error_message
+                        ? `我的插件遇到错误: ${args.error_message}`
+                        : "我想调试我的 Zhin 插件",
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("best-practices", {
+        description: "Zhin 开发的最佳实践建议",
+    }, async () => ({
+        description: "Zhin 开发最佳实践",
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "请告诉我 Zhin 开发的最佳实践",
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/lib/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,cAAc,CACnB,wBAAwB,EACxB;QACE,WAAW,EAAE,qBAAqB;QAClC,UAAU,EAAE;YACV,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;SACnF;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACf,WAAW,EAAE,MAAM,IAAI,CAAC,YAAY,cAAc;QAClD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,UAAU,IAAI,CAAC,YAAY,2BAA2B;iBAC7D;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,cAAc,EACd;QACE,WAAW,EAAE,kBAAkB;QAC/B,UAAU,EAAE;YACV,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;SACtD;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACf,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,aAAa;wBACtB,CAAC,CAAC,aAAa,IAAI,CAAC,aAAa,EAAE;wBACnC,CAAC,CAAC,gBAAgB;iBACrB;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,gBAAgB,EAChB;QACE,WAAW,EAAE,gBAAgB;KAC9B,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,WAAW,EAAE,aAAa;QAC1B,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,mBAAmB;iBAC1B;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/lib/resources.d.ts

@@ -0,0 +1,50 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 资源列表定义
+ */
+export declare const resourceList: readonly [{
+    readonly uri: "zhin://docs/architecture";
+    readonly name: "Zhin 架构文档";
+    readonly description: "Zhin 框架的四层抽象设计和核心架构";
+}, {
+    readonly uri: "zhin://docs/plugin-development";
+    readonly name: "插件开发指南";
+    readonly description: "如何开发 Zhin 插件的完整指南";
+}, {
+    readonly uri: "zhin://docs/best-practices";
+    readonly name: "最佳实践";
+    readonly description: "Zhin 开发的最佳实践和常见模式";
+}, {
+    readonly uri: "zhin://docs/command-system";
+    readonly name: "命令系统";
+    readonly description: "Zhin 命令系统的使用方法";
+}, {
+    readonly uri: "zhin://docs/component-system";
+    readonly name: "组件系统";
+    readonly description: "Zhin 消息组件系统的使用方法";
+}, {
+    readonly uri: "zhin://docs/context-system";
+    readonly name: "Context 系统";
+    readonly description: "函数式依赖注入和 Context 管理";
+}, {
+    readonly uri: "zhin://examples/basic-plugin";
+    readonly name: "基础插件示例";
+    readonly description: "一个完整的基础插件示例";
+}, {
+    readonly uri: "zhin://examples/command-plugin";
+    readonly name: "命令插件示例";
+    readonly description: "包含多个命令的插件示例";
+}, {
+    readonly uri: "zhin://examples/adapter";
+    readonly name: "适配器示例";
+    readonly description: "如何实现一个平台适配器";
+}];
+/**
+ * 资源内容映射
+ */
+export declare const resourceContents: Record<string, string>;
+/**
+ * 注册所有 MCP 资源
+ */
+export declare function registerResources(server: McpServer): void;
+//# sourceMappingURL=resources.d.ts.map

package/lib/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8Cf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoKnD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QA2BlD"}