feat(mcp): platform-mcp —— EIP4 MCP server 标准接入 Claude Code/Codex/OpenCode (G2)

- 新增 platform-mcp 模块(stdio MCP server,MCP Java SDK 1.1.0 / jackson2 路线)
- 注册 7 个 MCP 工具:eip4_auto_develop / list_page_recipes / validate_page_schema
  / list_components / access_check / list_entities / entity_attributes
  忠实转发 EIP4 REST,复用人审红线(产物恒 READY_FOR_HUMAN_REVIEW),不另开权限面
- 工具逻辑 TDD(Eip4McpTools 9 单测,注入 mock REST client)
- 真实 stdio JSON-RPC e2e:initialize 协商 + tools/list 返回 7 工具(schema 正确)
  + tools/call 链路(死端口优雅 isError)
- 坑:父 pom 为 amis 校验钉死 networknt 1.5.2,与 MCP 需要的 2.0.0(含 dialect.Dialects)
  冲突 → platform-mcp 显式覆盖 2.0.0(仅本模块)
- 文档:GAP 标记 G2 完成、平台 README + skills/README 加 MCP 接入说明

接入:claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url <env>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-22 14:37:02 +08:00
parent 5b06aeceff
commit 4a2080a4f6
10 changed files with 580 additions and 1 deletions

View File

@@ -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 \

View File

@@ -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/<name>/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 <env>`。
### G3 — Skills 覆盖面 + 安装/检查(P1)
**问题**:4 个 skill 覆盖不到「建模/选 recipe/权限/服务流诊断」等高频动作,agent 仍要猜。

View File

@@ -33,6 +33,18 @@ cd <project> && 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。

71
platform-mcp/pom.xml Normal file
View File

@@ -0,0 +1,71 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.eip4</groupId>
<artifactId>eip4-platform</artifactId>
<version>0.1.0-SNAPSHOT</version>
</parent>
<artifactId>platform-mcp</artifactId>
<name>platform-mcp</name>
<description>EIP4 MCP server:把 AI/元数据 REST 端点包成 MCP 工具,供 Claude Code/Codex/OpenCode 经 stdio 接入;复用 env/baseUrl 与人审红线</description>
<dependencies>
<dependency>
<groupId>io.modelcontextprotocol.sdk</groupId>
<artifactId>mcp-core</artifactId>
</dependency>
<dependency>
<groupId>io.modelcontextprotocol.sdk</groupId>
<artifactId>mcp-json-jackson2</artifactId>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
</dependency>
<!-- MCP 1.1.0 的 schema validator 需 networknt 2.0.0(含 dialect.Dialects);
父 pom 为 amis 校验钉死 1.5.2,这里显式覆盖,仅作用于本模块。 -->
<dependency>
<groupId>com.networknt</groupId>
<artifactId>json-schema-validator</artifactId>
<version>2.0.0</version>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<version>3.7.1</version>
<configuration>
<archive>
<manifest>
<mainClass>com.eip4.platform.mcp.Eip4McpServer</mainClass>
</manifest>
</archive>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
<appendAssemblyId>false</appendAssemblyId>
</configuration>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>

View File

@@ -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 通过标准协议驱动平台开发。
*
* <p>用法:{@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<SyncToolSpecification> 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<String, Object> 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;
}
}

View File

@@ -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,便于单测)。
*
* <p>红线复用:所有工具忠实转发到平台 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<Map<String, Object>, ToolResult> handler) {
}
List<McpToolDef> 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<String, Object> 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<String, Object> args) {
return forward("GET", "/api/ai/page-recipes", null);
}
ToolResult listComponents(Map<String, Object> args) {
return forward("GET", "/api/page/schema/components", null);
}
ToolResult listEntities(Map<String, Object> args) {
return forward("GET", "/api/meta/entities", null);
}
ToolResult validatePageSchema(Map<String, Object> args) {
return forward("POST", "/api/page/schema/validate", mapper.valueToTree(args.get("schema")));
}
ToolResult accessCheck(Map<String, Object> args) {
return forward("POST", "/api/ai/tools/access-check", mapper.valueToTree(args));
}
ToolResult entityAttributes(Map<String, Object> 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<String, Object> args, String key) {
Object value = args.get(key);
if (value == null) {
throw new IllegalArgumentException("缺少参数: " + key);
}
return String.valueOf(value);
}
private static String strOr(Map<String, Object> 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<String, Object> 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<String, Object> 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;
}
}
}

View File

@@ -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) {
}
}

View File

@@ -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<String> 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);
}
}
}

View File

@@ -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<String> 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;
}
}
}

14
pom.xml
View File

@@ -26,6 +26,7 @@
<module>platform-converter</module>
<module>platform-ai</module>
<module>platform-cli</module>
<module>platform-mcp</module>
<module>platform-parity</module>
<module>platform-app</module>
<!-- P3:Flowable 独立工作流服务(单客户交付四进程之一,独立可执行 jar,端口 8089) -->
@@ -81,6 +82,19 @@
<artifactId>platform-parity</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>com.eip4</groupId>
<artifactId>platform-mcp</artifactId>
<version>${project.version}</version>
</dependency>
<!-- G2: MCP Java SDK(BOM 管理版本;用 jackson2 路线与平台 jackson 2.x 一致) -->
<dependency>
<groupId>io.modelcontextprotocol.sdk</groupId>
<artifactId>mcp-bom</artifactId>
<version>1.1.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- 旧代码 dom4j 解析模板 XML(XPath 需 jaxen) -->
<dependency>
<groupId>org.dom4j</groupId>