用途:为构建健壮的 MCP 服务器提供指导,尤其针对 unity-mcp-server 的架构与模式,帮助把 AI 助手连接到外部系统。
主要能力与建议: 可靠性:优雅处理错误,避免意外崩溃。 可发现性:工具应有清晰、自描述的 schema。 性能:尽量减少延迟,尤其是 stdio 传输。 协议合规:严格遵循 JSON-RPC 2.0 与 MCP 规范。
架构模式:每个工具使用一个处理器类(Handler),封装输入校验(Zod schema)、业务逻辑执行、错误处理与响应格式化。处理器需调用 super() 传入工具元数据,实现 execute(params) 方法,返回普通对象(框架负责 JSON-RPC 包装),并以描述性消息抛出错误。输入处理前一律使用 Zod 校验。
传输层:stdio 使用 LSP 风格的 Content-Length 分帧,输出始终使用 Content-Length,同一会话不得混用分帧格式;为兼容客户端可同时接受 Content-Length 与 NDJSON 输入(如 Claude Desktop 用 Content-Length,部分 CLI 工具用 NDJSON)。
错误处理:使用 MCP 规范错误码(ParseError -32700、InvalidRequest -32600、MethodNotFound -32601、InvalidParams -32602、InternalError -32603),并按规定的错误响应格式返回。
Unity 相关模式:命令采用简单请求/响应模式;涉及文件路径的命令始终包含 workspaceRoot。
测试:对处理器采用 TDD,先定义契约测试,模拟 Unity 连接隔离逻辑,测试错误路径后再测正常路径;集成测试覆盖含 JSON-RPC 分帧的完整请求/响应周期。
常见错误:混用分帧格式、吞掉错误、缺少校验、阻塞 stdio(应全程使用 async/await)。处理器需在中央索引中集中注册。
限制:资料未提供该技能的收费、价格、适用平台或具体安装步骤,暂未提供。