SuperAPI AI 工具集

mcp-server-development

编程与开发

查看项目

更新于 10-15 19:54

技能介绍

用途:为开发 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。处理器需在中心索引统一注册。

限制:资料未提供具体安装命令、依赖版本、收费与平台信息,暂未提供。