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

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