@c4a/mcp-client 0.3.7-alpha.1

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@c4a/mcp-client",
+  "version": "0.3.7-alpha.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./src/index.ts",
+  "bin": {
+    "c4a-mcp-client": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./src/server.ts",
+      "default": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "bun --watch src/index.ts",
+    "start": "bun run src/index.ts",
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun",
+    "test": "bun test",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@c4a/core": "workspace:*",
+    "@c4a/extract": "workspace:*",
+    "zod": "^3.23.0",
+    "typescript": "^5.4.0",
+    "@types/bun": "latest"
+  }
+}

package/src/__tests__/smoke.test.ts

@@ -0,0 +1,9 @@
+import { describe, expect, test } from "bun:test";
+import { createServer } from "../server.js";
+
+describe("mcp-client smoke", () => {
+  test("createServer returns instance", () => {
+    const server = createServer();
+    expect(server).toBeTruthy();
+  });
+});

package/src/index.ts

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+/**
+ * @c4a/mcp-client - 本地 extract MCP Server
+ *
+ * 提供 extract_* 工具（接口提取/分析/AST/契约）
+ *
+ * 运行方式: stdio（必须本地）
+ *
+ * 环境变量:
+ * - MCP_TRANSPORT: 仅允许 stdio（默认 stdio）
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+
+const transport = process.env.MCP_TRANSPORT || "stdio";
+
+async function startStdioServer() {
+  const server = createServer();
+  const stdioTransport = new StdioServerTransport();
+  await server.connect(stdioTransport);
+  console.error("c4a-mcp-client server started (stdio)");
+}
+
+async function main() {
+  if (transport !== "stdio") {
+    console.error(
+      `c4a-mcp-client 仅支持 stdio 模式，当前 MCP_TRANSPORT=${transport}`
+    );
+    process.exit(1);
+  }
+
+  await startStdioServer();
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/src/schemas/inputSchemas.ts

@@ -0,0 +1,87 @@
+import { z } from "zod";
+
+export const SupportedLanguageSchema = z.enum(["typescript", "go"]);
+
+export const ExtractInputSchema = z.object({
+  path: z.string().describe("File or directory path to extract from"),
+  language: SupportedLanguageSchema.optional().describe(
+    "Language hint (auto-detected if not provided)"
+  ),
+  recursive: z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe("Recursively process directories"),
+  include: z
+    .array(z.string())
+    .optional()
+    .describe("Glob patterns to include (e.g., ['**/*.ts'])"),
+  exclude: z
+    .array(z.string())
+    .optional()
+    .describe("Glob patterns to exclude (e.g., ['node_modules/**'])"),
+});
+
+export const AnalyzeInputSchema = z.object({
+  path: z.string().describe("File or directory path to analyze"),
+  language: SupportedLanguageSchema.optional().describe(
+    "Language hint (auto-detected if not provided)"
+  ),
+  includeMetrics: z
+    .boolean()
+    .optional()
+    .default(true)
+    .describe("Include code metrics"),
+  includeDependencies: z
+    .boolean()
+    .optional()
+    .default(true)
+    .describe("Analyze and include dependencies"),
+  summary_only: z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe("Only return summary without file details"),
+  limit: z
+    .number()
+    .int()
+    .min(1)
+    .default(100)
+    .describe("File details limit"),
+  offset: z
+    .number()
+    .int()
+    .min(0)
+    .default(0)
+    .describe("Pagination offset"),
+});
+
+export const ASTInputSchema = z.object({
+  path: z.string().describe("File path to parse"),
+  language: SupportedLanguageSchema.optional().describe(
+    "Language hint (auto-detected if not provided)"
+  ),
+  maxDepth: z
+    .number()
+    .min(0)
+    .default(10)
+    .describe("Maximum AST depth to return"),
+  nodeTypes: z.array(z.string()).optional().describe("Filter to specific node types"),
+});
+
+export const ContractInputSchema = z.object({
+  path: z.string().describe("File or directory path to generate contract from"),
+  format: z
+    .enum(["openapi", "asyncapi", "proto"])
+    .default("openapi")
+    .describe("Output format"),
+  version: z.string().optional().default("3.0.0").describe("Spec version"),
+  title: z.string().optional().describe("API title"),
+  description: z.string().optional().describe("API description"),
+  baseUrl: z.string().optional().describe("Base URL for API"),
+});
+
+export type ExtractInput = z.infer<typeof ExtractInputSchema>;
+export type AnalyzeInput = z.infer<typeof AnalyzeInputSchema>;
+export type ASTInput = z.infer<typeof ASTInputSchema>;
+export type ContractInput = z.infer<typeof ContractInputSchema>;

package/src/server.ts

@@ -0,0 +1,13 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerExtractTools } from "./tools/extract.js";
+
+export function createServer(): McpServer {
+  const server = new McpServer({
+    name: "c4a-mcp-client",
+    version: "0.1.0",
+  });
+
+  registerExtractTools(server);
+
+  return server;
+}

package/src/shared/handler.ts

@@ -0,0 +1,42 @@
+import { errorToMcpResponse } from "@c4a/core/types";
+
+export type McpToolResponse = {
+  content: Array<{ type: "text"; text: string }>;
+  isError?: boolean;
+};
+
+function formatSuccess(result: unknown): McpToolResponse {
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
+  };
+}
+
+function formatError(error: unknown): McpToolResponse {
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(errorToMcpResponse(error), null, 2),
+      },
+    ],
+    isError: true,
+  };
+}
+
+export function buildToolHandler<TArgs, TResult>(
+  handler: (args: TArgs) => Promise<TResult>
+): (args: TArgs) => Promise<McpToolResponse> {
+  return async (args) => {
+    try {
+      const result = await handler(args);
+      return formatSuccess(result);
+    } catch (error) {
+      return formatError(error);
+    }
+  };
+}

package/src/tools/extract.ts

@@ -0,0 +1,50 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type {
+  AnalyzeInput,
+  ASTInput,
+  ContractInput,
+  ExtractInput,
+} from "../schemas/inputSchemas.js";
+import {
+  AnalyzeInputSchema,
+  ASTInputSchema,
+  ContractInputSchema,
+  ExtractInputSchema,
+} from "../schemas/inputSchemas.js";
+import {
+  extractAnalyze,
+  extractAST,
+  extractContract,
+  extractInterfaces,
+} from "@c4a/extract";
+import { buildToolHandler } from "../shared/handler.js";
+
+export function registerExtractTools(server: McpServer): void {
+  server.tool(
+    "extract_interfaces",
+    "从代码文件中提取接口、类型、类等定义",
+    ExtractInputSchema.shape,
+    buildToolHandler((args: ExtractInput) => extractInterfaces(args))
+  );
+
+  server.tool(
+    "extract_analyze",
+    "分析代码结构和依赖关系",
+    AnalyzeInputSchema.shape,
+    buildToolHandler((args: AnalyzeInput) => extractAnalyze(args))
+  );
+
+  server.tool(
+    "extract_ast",
+    "获取代码文件的 AST 抽象语法树结构",
+    ASTInputSchema.shape,
+    buildToolHandler((args: ASTInput) => extractAST(args))
+  );
+
+  server.tool(
+    "extract_contract",
+    "从代码生成 API 契约（OpenAPI、AsyncAPI、Proto）",
+    ContractInputSchema.shape,
+    buildToolHandler((args: ContractInput) => extractContract(args))
+  );
+}