短时间内连续调用工具时，服务端的某个区域（Area）被重复注册，讲promptx单独部署客户端的时候，工具同时多次出现竞态的问题

[yejunhao159]

这个报错 MCP error -32603: Area with name 'LEGACY' already registered 是 PromptX MCP 服务端的内部缓存冲突问题，不是你的调用参数有问题。

🔍 原因分析
问题 说明
错误类型 MCP 内部状态管理冲突
触发原因 短时间内连续调用工具时，服务端的某个区域（Area）被重复注册
影响 第一次调用失败，重试通常成功
✅ 解决方法
直接重试 - 像我刚才做的那样，再调用一次就好了
间隔几秒再调用 - 给服务端一点时间清理状态
如果频繁出现 - 可能需要重启 PromptX MCP 服务

[yejunhao159]

supergateway] Child stderr: [2026-01-10 09:30:26.955] INFO: @promptx/core [index.js:19939]
[supergateway] Child → SSE: {
jsonrpc: '2.0',
id: 15,
error: {
code: -32603,
message: "Area with name 'LEGACY' already registered"
}
}
[supergateway] Child stderr: [2026-01-10 09:30:35.060] ERROR: @promptx/mcp-server [chunk-24IGMB6F.js:497] [TOOL_EXEC_ERROR] Tool: toolx[supergateway] Child stderr: [2026-01-10 09:30:35.060] ERROR: @promptx/core [index.js:19947] 执行命令出错: Area with name 'LEGACY' already registered
[supergateway] POST to SSE transport (session 5b2966f7-80d5-40fc-9192-da627f68be3e)
[supergateway] SSE → Child (session 5b2966f7-80d5-40fc-9192-da627f68be3e):日志的具体问题

[yejunhao159]

问题分析

Area with name 'LEGACY' already registered

这个错误发生在 toolx 工具执行时：

1. 根本原因：PromptX 的 Area 系统在同一个进程中被多次初始化
2. 触发场景：每次调用 toolx 时，PromptX 尝试注册 "LEGACY" Area
3. 问题：Area 注册逻辑没有做幂等处理（即没有检查是否已注册）

临时解决方案

重启 PromptX MCP 服务器可以临时解决：

⏺ Bash(pkill -f "promptx mcp-server" 2>/dev/null; echo "已停止 PromptX MCP 服务器")
⎿ 已停止 PromptX MCP 服务器

⏺ 这是 PromptX 的已知问题

问题本质：

• PromptX MCP 服务器在处理多次 toolx 调用时
• 内部的 Area 注册代码会重复执行
• 但没有检查 Area 是否已存在

建议：

1. 这是 PromptX 库的 bug，应该向 @promptx/core 维护者报告
2. 修复方式应该是在注册 Area 前检查是否已存在：