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:
@@ -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。
|
||||
|
||||
Reference in New Issue
Block a user