用途:ts-agent-sdk 用于生成带类型的 TypeScript SDK,让 AI 智能体(主要是 Claude Code)通过 MCP 服务器与 Web 应用交互,用简洁的函数调用替代冗长的 JSON-RPC curl 命令。
主要能力:内置模板位于 templates/,可复制到目标项目的 scripts/sdk/ 目录作为起点: cp -r ~/.claude/skills/ts-agent-sdk/templates/* ./scripts/sdk/ 生成流程包括:扫描 src/server/modules/mcp*/server.ts 中的 MCP 服务器模块,识别 server.tool(...) 形式的工具定义;提取工具名称、描述、Zod 输入模式与 MCP 端点路径;把 Zod 模式转换为 TypeScript 接口;为每个工具生成模块客户端方法;生成可运行示例脚本;更新索引导出。
使用方式:生成模块使用小写名(如 mcp-docs → docs),方法用 camelCase(如 create_document → createDocument),类型用 PascalCase(如 CreateDocumentInput)。可用环境变量包括 SDK_MODE(local、remote、auto,默认 auto)、SDK_BASE_URL(默认 http://localhost:8787)、SDK_API_TOKEN(无默认值)。运行示例:SDK_API_TOKEN="your-token" SDK_BASE_URL="https://app.workers.dev" npx tsx scripts/sdk/examples/create-doc.ts
错误处理:提供 AuthError、ValidationError、NotFoundError、RateLimitError、MCPError、NetworkError 等类型化错误。工具变更后可重新生成 SDK,并保留 examples/ 中的自定义代码。
限制:资料未提供支持平台、收费或许可信息,部分细节暂未提供。