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:
@@ -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 \
|
||||
|
||||
@@ -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 仍要猜。
|
||||
|
||||
@@ -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
71
platform-mcp/pom.xml
Normal 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>
|
||||
@@ -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;
|
||||
}
|
||||
}
|
||||
@@ -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;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -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) {
|
||||
}
|
||||
}
|
||||
@@ -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);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -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
14
pom.xml
@@ -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>
|
||||
|
||||
Reference in New Issue
Block a user