Arcrun/mcp/src/tools/arcrun_get_component_guide.ts

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { toolName } from "../brand.js";
import { Env } from "../types.js";

/**
 * arcrun_get_component_guide — 取得零件開發指引
 * 呼叫 Component Registry GET /components/guide
 * AI 在開發新零件前應先讀取此指引
 */
export function registerGetComponentGuide(server: McpServer, env: Env, orgNamespace: string) {
  server.tool(
    toolName("get_component_guide"),
    "取得 arcrun 零件開發指引（Markdown 格式）。包含 TinyGo 白名單 import、禁止行為、component.contract.yaml 完整範例、本地測試指令。開發新零件前必須先讀取此指引。",
    {},
    async () => {
      try {
        if (!env.COMPONENT_REGISTRY) {
          return {
            content: [{ type: "text", text: "Error: COMPONENT_REGISTRY service binding is not configured." }],
            isError: true,
          };
        }

        const response = await env.COMPONENT_REGISTRY.fetch(
          "http://component-registry/components/guide",
          { method: "GET" },
        );

        if (!response.ok) {
          return {
            content: [{ type: "text", text: `Error fetching guide: ${await response.text()}` }],
            isError: true,
          };
        }

        const guide = await response.text();
        return {
          content: [{ type: "text", text: guide }],
        };
      } catch (error) {
        return {
          content: [{ type: "text", text: `Internal Error: ${error instanceof Error ? error.message : String(error)}` }],
          isError: true,
        };
      }
    }
  );
}