用途:为开发 MCP(模型上下文协议)服务器提供指导,重点针对 unity-mcp-server 的架构与模式,帮助把 AI 助手连接到外部系统。
主要能力与核心原则:服务器需可靠(优雅处理错误、不意外崩溃)、可发现(工具有清晰自文档化 schema)、高性能(尤其 stdio 传输要降低延迟)、协议合规(严格遵循 JSON-RPC 2.0 与 MCP 规范)。
架构模式:按工具采用一个处理器类,封装输入校验(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,先写契约测试定义输入/输出 schema,再模拟连接隔离逻辑、测试错误路径,最后测正常路径;集成测试覆盖完整请求/响应周期(含 JSON-RPC 分帧)。
常见错误:混用分帧格式、吞掉错误、缺少校验、阻塞 stdio。处理器需在中心索引统一注册。
限制:资料未提供具体安装命令、依赖版本、收费与平台信息,暂未提供。