@g_christine/zeny-mcp
v0.5.0
Published
Model Context Protocol workspace server for zeny.
Downloads
570
Readme
@g_christine/zeny-mcp
zeny 的 Model Context Protocol stdio 服务,要求 Node.js 24 或更高版本。
MCP 客户端使用 npm latest 版本启动,无需全局安装:
{
"mcpServers": {
"zeny": {
"command": "npx",
"args": [
"--yes",
"--package=@g_christine/zeny-mcp@latest",
"zeny-mcp"
]
}
}
}调用 core_status 可验证新版 Zeny Core 和代理是否正在运行。它只信任新版隔离数据目录中的
Core Owner、Manager 会话与健康接口身份,不扫描旧 Zan Proxy 的进程或监听端口。
所有工具固定返回以下六字段外壳:
{
"schemaVersion": 1,
"ok": true,
"type": "workspace.list",
"tool": "workspace_list",
"data": { "revision": "missing", "workspaces": [] },
"error": null
}type 按结果分为 core.status、workspace.list、workspace.detail、
workspace.mutation、workspace.export、workspace.apply 和 error。失败时
data 固定为 null,error 固定包含 code、message 和 details;
无详情时 details 为 null。每项工具均声明对应的 MCP outputSchema,
文本 content 是 structuredContent 的紧凑 JSON 镜像。
六字段信封适用于已进入工具 handler 的成功与业务错误。输入 Schema 校验失败、 未知工具等由 MCP SDK 处理的协议错误,保持标准 MCP 错误结果,不伪装成业务信封。
修改配置前应先调用 workspace_list 获取 revision;workspace_activate 只保存启用状态,
workspace_apply 才会把工作区应用到运行中的 zeny Core。
工作区默认保存在 ~/.front-end-proxy-v2/config.json,不会从旧 Zan Proxy
配置自动回填;可通过 ZAN_PROXY_WORKSPACE_CONFIG 显式覆盖。
