SuperAPI AI 工具集

ts-agent-sdk

智能体与模型

查看项目

更新于 10-16 09:59

技能介绍

用途:该技能为 AI 智能体(主要是 Claude Code)生成带类型的 TypeScript SDK,使其通过 MCP 服务器与 Web 应用交互,替代冗长的 JSON-RPC curl 命令。

主要能力:基于随技能打包的 templates/ 模板生成 SDK;扫描 src/server/modules/mcp*/server.ts 探测 MCP 服务器;从 server.tool(...) 定义中提取工具名称、描述、Zod 输入 schema 与 MCP 端点;将 Zod schema 转为 TypeScript 接口;为每个工具生成客户端方法;生成可运行示例脚本并更新索引导出。输出结构包含 index.ts、config.ts、errors.ts、client.ts,以及按模块划分的 types.ts、client.ts、index.ts 和 examples/。命名约定:模块名取 MCP 服务器名小写;方法名取工具名 camelCase;类型名 PascalCase。提供类型化错误:AuthError、ValidationError、NotFoundError、RateLimitError、MCPError、NetworkError。工具变更后可重新生成。

使用方式:将模板复制到目标项目 scripts/sdk/:cp -r ~/.claude/skills/ts-agent-sdk/templates/* ./scripts/sdk/。环境变量包括 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。

适用场景:为 MCP 驱动的 Web 应用生成类型安全调用层。限制:资料仅覆盖上述基础信息,未提供其他平台支持、收费或效果数据。