diff --git a/README.md b/README.md index a297d50..e1e0ac7 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,7 @@ EIP4 平台正式工程(路线 A'):双层制模块化单体——**保真层供 | platform-flow-gateway | P3 占位:Flowable 网关 | | | platform-ai | P5 AI Agent 开发底座:草稿/变更包/本地门禁/自动修复/人工部署包 | Agent 不直连线上执行生产变更 | | platform-cli | EIP4 Agent 受控命令入口:`init` 一键接入(Claude Code/Codex/OpenCode)、环境探测、AI 自动开发、发布编排 | Agent 优先通过 CLI/API 操作 | +| platform-mcp | EIP4 MCP server(stdio):把 AI/元数据 REST 端点包成 MCP 工具,供 Claude Code/Codex/OpenCode 经标准协议接入 | 忠实转发 REST,复用人审红线,不另开权限面 | | platform-parity | C1 对拍框架:录制/重放/RowDiff/自对拍 CLI | P1 一级交付物 | | platform-app | Boot 启动器,组装全部模块 | ArchUnit 规则在此模块测试里 | @@ -95,6 +96,11 @@ java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release import-pre java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release diff --left target/ai-runs/package-old.json --right target/ai-runs/package.json java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release rollback-plan --package-file target/ai-runs/package.eip4pkg.json --output target/ai-runs/rollback-plan.json +# EIP4 MCP server(stdio):把下面这些 AI/元数据端点包成 MCP 工具,供 Claude Code/Codex/OpenCode 用标准协议调用 +mvn -pl platform-mcp package +claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url http://localhost:8093 +# 或设 EIP4_BASE_URL;默认 http://localhost:8084。手动启动:java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar + # Typed page schema curl http://localhost:8084/api/page/schema/components curl -X POST http://localhost:8084/api/page/schema/validate \ diff --git a/docs/AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN.md b/docs/AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN.md index 913bb40..80fc5c1 100644 --- a/docs/AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN.md +++ b/docs/AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN.md @@ -88,7 +88,7 @@ eip4 release diff | export | import-preview | rollback-plan | verify **落地(2026-06-22)**:`eip4 init` 已实现于 `platform-cli`(`Eip4Cli.runInit`),TDD 4 个新测试 + 原有共 19 单测全绿。配套:`docs/skills/*.md` 的 base URL 改为 `{{EIP4_BASE_URL}}` 占位符;新增 `platform-cli/src/main/resources/eip4-skills/manifest.json`(skill 清单 + name/description);`pom.xml` 用 maven-resources-plugin 把 `docs/skills` 打进 jar。真实 jar 端到端验证通过:`init` 产出 `.claude/skills//SKILL.md`(带 frontmatter)+ 根 `AGENTS.md`(`EIP4-SKILLS` 标记块,块外内容保留、可重复执行,且**内嵌每个 skill 渲染后全文**——Claude Code 用 `.claude/skills/` 原生 skill,Codex/OpenCode 读 `AGENTS.md` 即得完整规程,三工具全覆盖),base URL 按 `--base-url`/`--env`/current env 渲染,零占位符残留。skills 随 jar 打包,`init` 默认从 classpath 读取,无需仓库在场。 -### G2 — MCP server(P1,接入面标准化) +### G2 — MCP server(P1,接入面标准化)✅ 已完成(2026-06-22) **问题**:现在 agent 要靠 skill 文档「死记」CLI/REST 用法;NocoBase 已用 MCP 把能力做成可发现、可调用的标准工具。 @@ -108,6 +108,8 @@ eip4 release diff | export | import-preview | rollback-plan | verify **成本**:中(一个独立 server 进程;建议先 stdio + 复用 REST,不重写业务)。 +**落地(2026-06-22)**:新增 `platform-mcp` 模块(stdio MCP server,MCP Java SDK 1.1.0 / jackson2 路线)。`McpServer.sync(StdioServerTransportProvider).tools(...).build()`,注册 7 个工具:`eip4_auto_develop / list_page_recipes / validate_page_schema / list_components / access_check / list_entities / entity_attributes`,忠实转发 EIP4 REST,复用人审红线、不另开权限面。工具逻辑 TDD(`Eip4McpTools` 9 单测,注入 mock REST client);真实 stdio JSON-RPC e2e 通过:`initialize` 协商 + `tools/list` 返回 7 工具(inputSchema 正确解析)+ `tools/call` 链路(死端口优雅 isError)。坑:父 pom 为 amis 校验钉死 `networknt:json-schema-validator:1.5.2`,与 MCP 需要的 `2.0.0`(含 `dialect.Dialects`)冲突 → 在 platform-mcp 显式覆盖 2.0.0(仅本模块)。接入:`claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url `。 + ### G3 — Skills 覆盖面 + 安装/检查(P1) **问题**:4 个 skill 覆盖不到「建模/选 recipe/权限/服务流诊断」等高频动作,agent 仍要猜。 diff --git a/docs/skills/README.md b/docs/skills/README.md index d0423fa..f2f73e8 100644 --- a/docs/skills/README.md +++ b/docs/skills/README.md @@ -33,6 +33,18 @@ cd && claude 参数:`--dir` 目标项目根(默认当前目录)、`--base-url` 或 `--env` 指定渲染地址、`--skills-dir` 用本地目录覆盖内置 skills。skills 已随 `platform-cli` jar 一起打包,`init` 默认从 jar 内读取,无需仓库在场。 +## MCP 接入(标准协议) + +除 skills + CLI 外,EIP4 还提供 MCP server(`platform-mcp`,stdio),把 `eip4_auto_develop / eip4_list_page_recipes / eip4_validate_page_schema / eip4_list_components / eip4_access_check / eip4_list_entities / eip4_entity_attributes` 暴露为 MCP 工具,让 Agent 用标准协议调用,而不必死记 CLI/REST 用法: + +```bash +mvn -pl platform-mcp package +claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url http://localhost:8094 +# 或设环境变量 EIP4_BASE_URL;默认 http://localhost:8084 +``` + +工具忠实转发到平台 REST,复用人审红线(产物恒 `READY_FOR_HUMAN_REVIEW`)与 `access-check`;MCP server 应只配本地/开发 baseUrl,不另开权限面。 + ## 通用原则 1. 优先使用 `platform-cli`,其次使用公开 REST API,最后才考虑人工 SQL。 diff --git a/platform-mcp/pom.xml b/platform-mcp/pom.xml new file mode 100644 index 0000000..add4da1 --- /dev/null +++ b/platform-mcp/pom.xml @@ -0,0 +1,71 @@ + + + 4.0.0 + + com.eip4 + eip4-platform + 0.1.0-SNAPSHOT + + platform-mcp + platform-mcp + EIP4 MCP server:把 AI/元数据 REST 端点包成 MCP 工具,供 Claude Code/Codex/OpenCode 经 stdio 接入;复用 env/baseUrl 与人审红线 + + + + io.modelcontextprotocol.sdk + mcp-core + + + io.modelcontextprotocol.sdk + mcp-json-jackson2 + + + com.fasterxml.jackson.core + jackson-databind + + + + com.networknt + json-schema-validator + 2.0.0 + + + org.junit.jupiter + junit-jupiter + test + + + + + + + org.apache.maven.plugins + maven-assembly-plugin + 3.7.1 + + + + com.eip4.platform.mcp.Eip4McpServer + + + + jar-with-dependencies + + false + + + + make-assembly + package + + single + + + + + + + diff --git a/platform-mcp/src/main/java/com/eip4/platform/mcp/Eip4McpServer.java b/platform-mcp/src/main/java/com/eip4/platform/mcp/Eip4McpServer.java new file mode 100644 index 0000000..2e2c8f4 --- /dev/null +++ b/platform-mcp/src/main/java/com/eip4/platform/mcp/Eip4McpServer.java @@ -0,0 +1,90 @@ +package com.eip4.platform.mcp; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.CountDownLatch; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import io.modelcontextprotocol.json.McpJsonMapper; +import io.modelcontextprotocol.json.jackson2.JacksonMcpJsonMapper; +import io.modelcontextprotocol.server.McpServer; +import io.modelcontextprotocol.server.McpServerFeatures.SyncToolSpecification; +import io.modelcontextprotocol.server.McpSyncServer; +import io.modelcontextprotocol.server.transport.StdioServerTransportProvider; +import io.modelcontextprotocol.spec.McpSchema; + +/** + * EIP4 MCP server(stdio):把 EIP4 的 AI / 元数据 REST 端点暴露为 MCP 工具, + * 供 Claude Code / Codex / OpenCode 通过标准协议驱动平台开发。 + * + *

用法:{@code java -jar platform-mcp.jar [--base-url URL]}, + * 或设环境变量 {@code EIP4_BASE_URL};默认 http://localhost:8084。 + * stdout 被 MCP JSON-RPC 占用,日志只走 stderr。 + */ +public final class Eip4McpServer { + + private static final String DEFAULT_BASE_URL = "http://localhost:8084"; + + private Eip4McpServer() { + } + + public static void main(String[] args) throws InterruptedException { + String baseUrl = resolveBaseUrl(args); + ObjectMapper objectMapper = new ObjectMapper(); + McpJsonMapper jsonMapper = new JacksonMcpJsonMapper(objectMapper); + Eip4McpTools tools = new Eip4McpTools(new JdkEip4RestClient(baseUrl, objectMapper), objectMapper); + + List toolSpecs = new ArrayList<>(); + for (Eip4McpTools.McpToolDef def : tools.toolDefs()) { + McpSchema.Tool tool = McpSchema.Tool.builder() + .name(def.name()) + .description(def.description()) + .inputSchema(jsonMapper, def.inputSchemaJson()) + .build(); + toolSpecs.add(SyncToolSpecification.builder() + .tool(tool) + .callHandler((exchange, request) -> { + Map arguments = request.arguments() == null ? Map.of() : request.arguments(); + Eip4McpTools.ToolResult result = def.handler().apply(arguments); + return McpSchema.CallToolResult.builder() + .addTextContent(result.text()) + .isError(result.isError()) + .build(); + }) + .build()); + } + + McpSyncServer server = McpServer.sync(new StdioServerTransportProvider(jsonMapper)) + .serverInfo("eip4", "0.1.0") + .capabilities(McpSchema.ServerCapabilities.builder().tools(true).build()) + .tools(toolSpecs) + .build(); + + System.err.println("EIP4 MCP server started (baseUrl=" + baseUrl + ", tools=" + toolSpecs.size() + ")"); + Runtime.getRuntime().addShutdownHook(new Thread(server::close)); + new CountDownLatch(1).await(); + } + + static String resolveBaseUrl(String[] args) { + for (int i = 0; i < args.length - 1; i++) { + if ("--base-url".equals(args[i])) { + return stripTrailingSlash(args[i + 1]); + } + } + String env = System.getenv("EIP4_BASE_URL"); + if (env != null && !env.isBlank()) { + return stripTrailingSlash(env); + } + return DEFAULT_BASE_URL; + } + + private static String stripTrailingSlash(String value) { + String out = value.trim(); + while (out.endsWith("/")) { + out = out.substring(0, out.length() - 1); + } + return out; + } +} diff --git a/platform-mcp/src/main/java/com/eip4/platform/mcp/Eip4McpTools.java b/platform-mcp/src/main/java/com/eip4/platform/mcp/Eip4McpTools.java new file mode 100644 index 0000000..d6a5240 --- /dev/null +++ b/platform-mcp/src/main/java/com/eip4/platform/mcp/Eip4McpTools.java @@ -0,0 +1,178 @@ +package com.eip4.platform.mcp; + +import java.util.List; +import java.util.Map; +import java.util.function.Function; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; + +/** + * 把 EIP4 的 AI / 元数据 REST 端点封装成 MCP 工具的纯逻辑层(不依赖 MCP SDK,便于单测)。 + * + *

红线复用:所有工具忠实转发到平台 REST,平台已有的人审门禁(产物恒 READY_FOR_HUMAN_REVIEW)、 + * access-check 与安全门负责权限/生产写控制;本层不另开权限面。MCP server 应只配本地/开发 baseUrl。 + */ +final class Eip4McpTools { + + private static final String EMPTY_SCHEMA = "{\"type\":\"object\",\"properties\":{}}"; + + private final Eip4RestClient client; + private final ObjectMapper mapper; + + Eip4McpTools(Eip4RestClient client, ObjectMapper mapper) { + this.client = client; + this.mapper = mapper; + } + + record ToolResult(String text, boolean isError) { + } + + record McpToolDef(String name, String description, String inputSchemaJson, + Function, ToolResult> handler) { + } + + List toolDefs() { + return List.of( + new McpToolDef("eip4_auto_develop", + "AI 辅助生成一个新功能(实体+页面+服务流+菜单)并在本地跑门禁,产出待人工复核的部署包(恒 READY_FOR_HUMAN_REVIEW,生产写由平台阻断)。", + """ + {"type":"object", + "required":["objective","featureName","tableName","entityName","templateId","menuName","fields"], + "properties":{ + "objective":{"type":"string","description":"功能目标"}, + "featureName":{"type":"string"}, + "tableName":{"type":"string","description":"业务表名"}, + "entityName":{"type":"string"}, + "templateId":{"type":"string"}, + "menuName":{"type":"string"}, + "fields":{"type":"array","items":{"type":"object", + "required":["column","label","type"], + "properties":{"column":{"type":"string"},"label":{"type":"string"}, + "type":{"type":"string"},"length":{"type":"integer"},"required":{"type":"boolean"}}}}, + "pageRecipe":{"type":"string","enum":["maintenance-crud-v1","tree-crud-v1","master-detail-v1"],"default":"maintenance-crud-v1"}, + "maxRepairAttempts":{"type":"integer","default":2}, + "generateDeploymentPackage":{"type":"boolean","default":true}}} + """, + this::autoDevelop), + new McpToolDef("eip4_list_page_recipes", + "列出可用的页面 recipe(maintenance-crud-v1 / tree-crud-v1 / master-detail-v1)。", + EMPTY_SCHEMA, this::listPageRecipes), + new McpToolDef("eip4_list_components", + "列出 typed page schema 注册的组件能力表(AI 只能使用其中的组件/动作)。", + EMPTY_SCHEMA, this::listComponents), + new McpToolDef("eip4_validate_page_schema", + "对一个 amis 页面 schema 做 typed schema 离线校验(不写库)。", + """ + {"type":"object","required":["schema"], + "properties":{"schema":{"type":"object","description":"待校验的 amis 页面 schema"}}} + """, + this::validatePageSchema), + new McpToolDef("eip4_access_check", + "检查某 AI employee 对某工具/目标环境的权限(生产写默认阻断)。", + """ + {"type":"object","required":["employeeId","toolName","targetEnv"], + "properties":{"employeeId":{"type":"string"},"toolName":{"type":"string"}, + "grantedScopes":{"type":"array","items":{"type":"string"}}, + "targetEnv":{"type":"string"},"productionWrite":{"type":"boolean"}}} + """, + this::accessCheck), + new McpToolDef("eip4_list_entities", + "列出已登记的元数据实体。", + EMPTY_SCHEMA, this::listEntities), + new McpToolDef("eip4_entity_attributes", + "查询某业务表的字段(实体属性)。", + """ + {"type":"object","required":["table"], + "properties":{"table":{"type":"string","description":"业务表名"}}} + """, + this::entityAttributes)); + } + + ToolResult autoDevelop(Map args) { + ObjectNode feature = mapper.createObjectNode(); + feature.put("objective", str(args, "objective")); + feature.put("featureName", str(args, "featureName")); + feature.put("tableName", str(args, "tableName")); + feature.put("entityName", str(args, "entityName")); + feature.put("templateId", str(args, "templateId")); + feature.put("menuName", str(args, "menuName")); + feature.put("pageRecipe", strOr(args, "pageRecipe", "maintenance-crud-v1")); + feature.set("fields", mapper.valueToTree(args.getOrDefault("fields", List.of()))); + ObjectNode body = mapper.createObjectNode(); + body.set("feature", feature); + body.put("generateDeploymentPackage", boolOr(args, "generateDeploymentPackage", true)); + body.put("maxRepairAttempts", intOr(args, "maxRepairAttempts", 2)); + return forward("POST", "/api/ai/features/auto-develop", body); + } + + ToolResult listPageRecipes(Map args) { + return forward("GET", "/api/ai/page-recipes", null); + } + + ToolResult listComponents(Map args) { + return forward("GET", "/api/page/schema/components", null); + } + + ToolResult listEntities(Map args) { + return forward("GET", "/api/meta/entities", null); + } + + ToolResult validatePageSchema(Map args) { + return forward("POST", "/api/page/schema/validate", mapper.valueToTree(args.get("schema"))); + } + + ToolResult accessCheck(Map args) { + return forward("POST", "/api/ai/tools/access-check", mapper.valueToTree(args)); + } + + ToolResult entityAttributes(Map args) { + return forward("GET", "/api/meta/entity/" + str(args, "table") + "/attributes", null); + } + + private ToolResult forward(String method, String path, JsonNode body) { + Eip4RestClient.Response response = client.send(method, path, body); + boolean error = response.status() < 200 || response.status() >= 300; + String text = error + ? "EIP4 " + method + " " + path + " 返回 HTTP " + response.status() + ":\n" + response.body() + : response.body(); + return new ToolResult(text, error); + } + + private static String str(Map args, String key) { + Object value = args.get(key); + if (value == null) { + throw new IllegalArgumentException("缺少参数: " + key); + } + return String.valueOf(value); + } + + private static String strOr(Map args, String key, String fallback) { + Object value = args.get(key); + return value == null || String.valueOf(value).isBlank() ? fallback : String.valueOf(value); + } + + private static boolean boolOr(Map args, String key, boolean fallback) { + Object value = args.get(key); + if (value instanceof Boolean b) { + return b; + } + return value == null ? fallback : Boolean.parseBoolean(String.valueOf(value)); + } + + private static int intOr(Map args, String key, int fallback) { + Object value = args.get(key); + if (value instanceof Number n) { + return n.intValue(); + } + if (value == null) { + return fallback; + } + try { + return Integer.parseInt(String.valueOf(value)); + } catch (NumberFormatException ex) { + return fallback; + } + } +} diff --git a/platform-mcp/src/main/java/com/eip4/platform/mcp/Eip4RestClient.java b/platform-mcp/src/main/java/com/eip4/platform/mcp/Eip4RestClient.java new file mode 100644 index 0000000..61bf513 --- /dev/null +++ b/platform-mcp/src/main/java/com/eip4/platform/mcp/Eip4RestClient.java @@ -0,0 +1,15 @@ +package com.eip4.platform.mcp; + +import com.fasterxml.jackson.databind.JsonNode; + +/** + * EIP4 REST 调用抽象,便于单测注入。path 是相对 baseUrl 的路径(以 / 开头)。 + * body 为 null 表示无请求体(GET)。 + */ +interface Eip4RestClient { + + Response send(String method, String path, JsonNode body); + + record Response(int status, String body) { + } +} diff --git a/platform-mcp/src/main/java/com/eip4/platform/mcp/JdkEip4RestClient.java b/platform-mcp/src/main/java/com/eip4/platform/mcp/JdkEip4RestClient.java new file mode 100644 index 0000000..4e92882 --- /dev/null +++ b/platform-mcp/src/main/java/com/eip4/platform/mcp/JdkEip4RestClient.java @@ -0,0 +1,48 @@ +package com.eip4.platform.mcp; + +import java.net.URI; +import java.net.http.HttpClient; +import java.net.http.HttpRequest; +import java.net.http.HttpResponse; +import java.time.Duration; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +/** 基于 JDK HttpClient 的 EIP4 REST 调用实现。 */ +final class JdkEip4RestClient implements Eip4RestClient { + + private final HttpClient http = HttpClient.newBuilder() + .connectTimeout(Duration.ofSeconds(10)) + .build(); + private final ObjectMapper mapper; + private final String baseUrl; + + JdkEip4RestClient(String baseUrl, ObjectMapper mapper) { + this.baseUrl = baseUrl; + this.mapper = mapper; + } + + @Override + public Response send(String method, String path, JsonNode body) { + try { + HttpRequest.Builder builder = HttpRequest.newBuilder() + .uri(URI.create(baseUrl + path)) + .timeout(Duration.ofSeconds(60)) + .header("Accept", "application/json"); + if (body == null) { + builder.method(method, HttpRequest.BodyPublishers.noBody()); + } else { + builder.header("Content-Type", "application/json") + .method(method, HttpRequest.BodyPublishers.ofString(mapper.writeValueAsString(body))); + } + HttpResponse response = http.send(builder.build(), HttpResponse.BodyHandlers.ofString()); + return new Response(response.statusCode(), response.body()); + } catch (InterruptedException ex) { + Thread.currentThread().interrupt(); + return new Response(599, "请求被中断: " + ex.getMessage()); + } catch (Exception ex) { + return new Response(599, "请求失败(baseUrl=" + baseUrl + "): " + ex); + } + } +} diff --git a/platform-mcp/src/test/java/com/eip4/platform/mcp/Eip4McpToolsTest.java b/platform-mcp/src/test/java/com/eip4/platform/mcp/Eip4McpToolsTest.java new file mode 100644 index 0000000..4424d27 --- /dev/null +++ b/platform-mcp/src/test/java/com/eip4/platform/mcp/Eip4McpToolsTest.java @@ -0,0 +1,143 @@ +package com.eip4.platform.mcp; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +class Eip4McpToolsTest { + + private final ObjectMapper mapper = new ObjectMapper(); + private CapturingClient client; + private Eip4McpTools tools; + + @BeforeEach + void setUp() { + client = new CapturingClient(); + tools = new Eip4McpTools(client, mapper); + } + + @Test + void autoDevelopPostsAssembledFeatureToEndpoint() { + client.response = new Eip4RestClient.Response(200, "{\"status\":\"READY_FOR_HUMAN_REVIEW\"}"); + + Eip4McpTools.ToolResult result = tools.autoDevelop(Map.of( + "objective", "新增客户等级维护", + "featureName", "客户等级维护", + "tableName", "EIP4AI_CUSTOMER_LEVEL", + "entityName", "客户等级", + "templateId", "eip4ai-customer-level", + "menuName", "客户等级维护", + "fields", List.of(Map.of("column", "NAME", "label", "名称", "type", "string")))); + + assertEquals("POST", client.method); + assertEquals("/api/ai/features/auto-develop", client.path); + assertEquals("EIP4AI_CUSTOMER_LEVEL", client.body.path("feature").path("tableName").asText()); + assertEquals(1, client.body.path("feature").path("fields").size()); + assertEquals("NAME", client.body.path("feature").path("fields").get(0).path("column").asText()); + assertTrue(client.body.path("generateDeploymentPackage").asBoolean(), "default: generate deployment package"); + assertFalse(result.isError()); + assertTrue(result.text().contains("READY_FOR_HUMAN_REVIEW")); + } + + @Test + void autoDevelopDefaultsPageRecipeWhenMissing() { + tools.autoDevelop(Map.of( + "objective", "x", "featureName", "f", "tableName", "T", + "entityName", "E", "templateId", "t", "menuName", "M", + "fields", List.of(Map.of("column", "C", "label", "标签", "type", "string")))); + assertEquals("maintenance-crud-v1", client.body.path("feature").path("pageRecipe").asText()); + } + + @Test + void listPageRecipesGetsEndpoint() { + client.response = new Eip4RestClient.Response(200, "[\"maintenance-crud-v1\",\"tree-crud-v1\"]"); + Eip4McpTools.ToolResult result = tools.listPageRecipes(Map.of()); + assertEquals("GET", client.method); + assertEquals("/api/ai/page-recipes", client.path); + assertFalse(result.isError()); + assertTrue(result.text().contains("tree-crud-v1")); + } + + @Test + void listComponentsAndEntitiesUseReadEndpoints() { + tools.listComponents(Map.of()); + assertEquals("GET", client.method); + assertEquals("/api/page/schema/components", client.path); + + tools.listEntities(Map.of()); + assertEquals("GET", client.method); + assertEquals("/api/meta/entities", client.path); + } + + @Test + void entityAttributesBuildsPathFromTableArg() { + tools.entityAttributes(Map.of("table", "OA_NOTICE")); + assertEquals("GET", client.method); + assertEquals("/api/meta/entity/OA_NOTICE/attributes", client.path); + } + + @Test + void validatePageSchemaPostsRawSchema() { + tools.validatePageSchema(Map.of("schema", Map.of("type", "page", "body", List.of()))); + assertEquals("POST", client.method); + assertEquals("/api/page/schema/validate", client.path); + assertEquals("page", client.body.path("type").asText()); + } + + @Test + void accessCheckPostsToToolsAccessCheck() { + tools.accessCheck(Map.of( + "employeeId", "agent-developer", + "toolName", "local.apply", + "targetEnv", "local", + "productionWrite", false)); + assertEquals("POST", client.method); + assertEquals("/api/ai/tools/access-check", client.path); + assertEquals("agent-developer", client.body.path("employeeId").asText()); + } + + @Test + void nonSuccessStatusMarksError() { + client.response = new Eip4RestClient.Response(500, "boom"); + Eip4McpTools.ToolResult result = tools.listPageRecipes(Map.of()); + assertTrue(result.isError()); + assertTrue(result.text().contains("boom")); + } + + @Test + void toolDefsCoverAllSevenToolsWithSchema() { + List names = tools.toolDefs().stream().map(Eip4McpTools.McpToolDef::name).toList(); + assertTrue(names.contains("eip4_auto_develop")); + assertTrue(names.contains("eip4_list_page_recipes")); + assertTrue(names.contains("eip4_list_components")); + assertTrue(names.contains("eip4_validate_page_schema")); + assertTrue(names.contains("eip4_access_check")); + assertTrue(names.contains("eip4_list_entities")); + assertTrue(names.contains("eip4_entity_attributes")); + tools.toolDefs().forEach(d -> assertFalse(d.inputSchemaJson().isBlank(), "schema required: " + d.name())); + } + + private static final class CapturingClient implements Eip4RestClient { + private Response response = new Response(200, "{}"); + private String method; + private String path; + private JsonNode body; + + @Override + public Response send(String method, String path, JsonNode body) { + this.method = method; + this.path = path; + this.body = body; + return response; + } + } +} diff --git a/pom.xml b/pom.xml index b8f7daa..c90d921 100644 --- a/pom.xml +++ b/pom.xml @@ -26,6 +26,7 @@ platform-converter platform-ai platform-cli + platform-mcp platform-parity platform-app @@ -81,6 +82,19 @@ platform-parity ${project.version} + + com.eip4 + platform-mcp + ${project.version} + + + + io.modelcontextprotocol.sdk + mcp-bom + 1.1.0 + pom + import + org.dom4j