Pachca API 智能体工具链
为 AI 编程助手提供 Pachca 企业通讯 API 的 MCP 服务器、技能、CLI 与六语言 SDK。
- Star 数
- ★ 11
- 最近更新
- 3 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 59/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude Code · Claude.ai
- 开始前需要
- 典型场景
- 使用 Claude Code 或 Cursor 的开发者，希望智能体直接读写 Pachca 中的消息、会话与用户。
- 主要局限
- 所有能力都围绕 Pachca 企业通讯平台，脱离该平台没有使用价值。
- 源码审查
- 59/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
这是 Pachca 企业通讯平台官方的 API 工具链仓库：以 TypeSpec 编写 API 定义，再从中生成 OpenAPI 规范、CLI、六种语言的 SDK、n8n 节点、MCP 服务器工具清单以及面向 AI 智能体的文档与技能。仓库本身不是独立运行的智能体，而是提供给 Claude Code、Codex、VS Code、Cursor 等智能体使用的接口层。核心交付包括托管在 https://mcp.pachca.com/mcp 的 MCP 服务器、@pachca/cli 命令行工具、九个手工编写的技能及插件、TypeScript/Python/Go/Kotlin/Swift/C# SDK，以及 n8n 社区节点。所有这些都围绕同一份 OpenAPI 规范生成，保证接口、示例与文档一致。使用时需要一个 Pachca 个人访问令牌或通过 OAuth 登录。
仓库以 packages/spec 中的 typespec.tsp 为唯一事实来源，经 tsp compile 生成 openapi.yaml，再分发到下游：generate-cli 生成 @pachca/cli 的命令与数据；generator 生成 sdk/ 下六种语言的客户端；generate-mcp 生成 mcp-manifest.json 作为 mcp.pachca.com 服务器的工具清单；generate-n8n 生成集成节点；apps/docs 的 Next.js 站点据此生成方法页、llms.txt、llms-full.txt、每个方法的 Markdown 以及 Postman 集合。CLI 暴露每个 API 方法为子命令（如 pachca messages create --entity-id=123 --content="…"），并提供 pachca api ls、--describe 等内嵌 API 参考。MCP 服务器按员工角色、套餐与令牌类型暴露不同工具，工具说明中带有每个方法的规则。九个技能（如 pachca-messaging、pachca-search、pachca-watch-thread）通过 npx skills add 或插件安装，指导智能体完成多步任务。
- 使用 Claude Code 或 Cursor 的开发者，希望智能体直接读写 Pachca 中的消息、会话与用户。
- 运维或自动化工程师，需要在 n8n 中无代码地编排 100 多个 Pachca 操作与 Webhook 触发器。
- 后端团队，希望在 TypeScript、Python、Go、Kotlin、Swift 或 C# 项目中直接调用类型安全的 Pachca 客户端。
- 在 CI 或脚本中调用 Pachca API 的团队，用 @pachca/cli 的 4 种输出格式与游标分页完成集成。
- 需要让智能体完成跨多步任务（如汇总长线程、按结论提醒）的产品或支持团队。
- 使用自建 OpenAPI 工具链、需要标准 openapi.yaml 与 Postman/Bruno 集合的 API 集成方。
如何安装或部署这个 Agent？
安装 CLI 并登录：
npm install -g @pachca/cli
pachca auth login或将 MCP 服务器添加到 Claude Code：
claude mcp add --transport http pachca https://mcp.pachca.com/mcp安装技能（需要 Node.js 22.20 或更新版本）：
npx skills add https://dev.pachca.com -g -a claude-code -y以插件方式在 Claude Code 中安装：
claude plugin marketplace add pachca/openapi --sparse .claude-plugin plugins
claude plugin install pachca@pachcaCodex：
codex plugin marketplace add pachca/openapi --sparse .agents/plugins --sparse plugins/pachca
codex plugin add pachca@pachcaGitHub Copilot CLI 与 VS Code：
copilot plugin marketplace add pachca/openapi
copilot plugin install pachca@pachca如何使用这个 Agent？
用 npx 直接执行 CLI 命令：
npx @pachca/cli messages create --entity-id=123 --content="Привет!" --token $PACHCA_TOKEN在终端中浏览内置 API 参考：
pachca api ls
pachca api POST /messages --describe
pachca api POST /messages -F 'message[entity_id]=123' -f 'message[content]=Привет'在代码中使用 SDK：
import { PachcaClient } from "@pachca/sdk";
const pachca = new PachcaClient("YOUR_TOKEN");
const users = await pachca.users.listUsers();
await pachca.reactions.addReaction(messageId, { code: "👍" });在自有项目中生成客户端：
npx @pachca/generator --output ./generated --lang typescript,python在 n8n 中安装社区节点：
npm install n8n-nodes-pachca这个 Agent 有哪些优点和局限？
- 单一 TypeSpec 源自动生成 OpenAPI、CLI、六语言 SDK、n8n 节点和 MCP 工具清单，接口与文档不会漂移。
- 同时提供 MCP 服务器、CLI 与技能三层接口，覆盖智能体对话、终端脚本与代码集成三类使用方式。
- 官方 MCP 服务器已在官方注册表发布（com.pachca/mcp），并针对角色、套餐、令牌类型做工具可见性控制。
- SDK 遵循统一调用模式 PachcaClient(token) → client.service.method(request)，并在六种语言中保持命名风格一致。
- 提供 llms.txt、llms-full.txt、每页 Markdown 和 skill.md 等面向智能体的可发现文档，支持 CORS。
- 所有能力都围绕 Pachca 企业通讯平台，脱离该平台没有使用价值。
- 安装技能需要 Node.js 22.20 或更高版本，且需单独执行 npx skills add 或插件安装。
- MCP 服务器运行在 Pachca 后端，仓库内只有工具清单，无法自行部署该服务器。
- 插件同时安装 MCP 与技能后不能再通过 npx skills 安装技能，否则会得到重复副本。
- Cusror 中插件服务器需要 PACHCA_TOKEN 环境变量中的个人令牌，登录流程与其他平台不同。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Pachca API 智能体工具链 当前 | 59 · 缺口较多 | — | ★ 11 | 3 天前 | TypeScript | ChatGPT · Codex · Claude Code · Claude.ai |
| Fusio | 52 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 2.1k | 11 天前 | PHP | ChatGPT |
| CC Workflow Studio | 50 · 缺口较多 | IDE 插件免费 + 模型费 | ★ 5.5k | 3 个月前 | TypeScript | ChatGPT · Codex · Claude Code |
| MobileBuildMCP | 49 · 缺口较多 | 命令行工具免费 | ★ 6.5k | 15 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 说明 MCP 工具按员工角色、套餐与令牌类型裁剪，CLI 建议在本人终端执行 `pachca auth login` 而非在 agent 命令中执行，属于最小权限与敏感凭据处理的正面信号，但均为文字声明，未见代码级权限校验或确认流程，故 least_privilege、user_confirmation、sensitive_data_handling 各记 1。数据流方面仅描述 MCP 服务运行在 Pachca 后端、技能通过 CLI 访问，未给出数据留存或传输细节，记 1。依赖安全方面 package.json 仅列出常规 devDependencies 与 trustedDependencies，无审计或锁定策略说明，记 1。外部影响方面技能 `pachca-watch-thread` 会运行后台脚本并调用 CLI，但无回滚或撤销机制说明，external_effects 与 rollback 各记 1。来源归属有 MIT LICENSE 与明确版权方 Pachca，记 2；但发布者身份未经 FollowAgents 验证，未额外加分。
仓库以 TypeSpec 为单一事实源生成 OpenAPI、SDK、CLI、n8n 节点，并有 check.yml 校验 changelog 同步、生成文件同步、文档格式与 markdown，自洽性较强，记 2。依赖可用性方面 README 给出 npm/PyPI/NuGet/JitPack 等注册表徽章与安装命令，依赖可从公开注册表获取，记 2。失败信息方面仅提及 CLI 有校验与错误处理、技能覆盖“缺少权限或工具”场景，但未见具体错误码或诊断输出示例，记 1。
README 明确区分 MCP 服务器、CLI、技能与插件、SDK、n8n 等受众与场景，并列出 Claude Code、Codex、VS Code、Cursor、Copilot 等客户端，audience_and_scenarios 记 3。能力边界方面说明技能只含指令、`pachca-watch-thread` 例外需 Node.js 22.20+ 与 CLI 登录，边界较清楚，但未系统列出不支持的能力，记 2。触发精度方面称 agent 会按任务自动匹配技能，并给出 `/pachca-watch-thread` 等显式调用方式，但无触发条件细节，记 2。环境适配方面覆盖多客户端与多语言 SDK，但部分文档仅俄文，且 Node 版本要求较新，记 2。
README 结构清晰，按 MCP/CLI/技能/SDK/n8n/测试/AI 集成分节，信息架构记 3。安装说明详尽，含 npx、全局安装、插件市场命令与手动安装链接，记 3。命名稳定性方面 SDK 命名规则明确（operationId 去前缀、各语言风格），但 n8n 存在 V1/V2 兼容映射与别名操作，说明命名曾发生迁移，记 2。示例与 FAQ 有 TypeScript 示例与 CLI 示例，但缺少 FAQ 与常见问题排查，记 2。已知限制仅零散提及（如不要在已有插件的 agent 中重复安装技能），未集中列出，记 1。许可证为 MIT 全文，记 3。版本与变更方面有 releases.json、docs/releases.md 与 changelog 同步检查，但仓库内未见完整 CHANGELOG 文件，记 2。维护责任方面仅有 Issues 与邮箱，未说明维护者、SLA 或弃用策略，且发布者未验证，记 1。
输出可用性方面 CLI 提供 table/JSON/YAML/CSV 四种格式、分页与 `--describe`，SDK 有统一调用模式，输出可直接使用，记 2。边际价值方面在已有 OpenAPI 之上提供 MCP 工具、技能与多语言 SDK，对 agent 场景有增量价值，但核心仍是 API 封装，记 2。成本效益方面技能可减少上下文消耗、CLI 内置 API 参考避免打开文档站，但需 Node.js 22.20+ 与额外安装步骤，记 2。
claim_traceability：README 中多数声明可对应到仓库文件（LICENSE、package.json、workflows、测试文件），但 MCP 服务器运行于后端、技能发布到 dev.pachca.com 等无法在仓库内核实，记 2。cross_source_corroboration：n8n 测试文件与 README 对 V1/V2 兼容、分页、凭据校验的描述相互印证，记 2。fact_inference_separation：README 将“技能由人工编写、构建时校验”与生成物区分，但部分能力描述（如 agent 自动选择技能）属推断性表述，未标注证据，记 1。
- MCP 服务器运行在 Pachca 后端，仓库内无法核实其权限裁剪、数据留存与传输安全，需在部署前独立评估。
- 技能 `pachca-watch-thread` 会运行后台 Node.js 脚本并调用 CLI，需确认其凭据来源与撤销方式。
- 发布者身份未经 FollowAgents 验证，安装插件或技能前应核对来源与签名。
- 部分文档仅提供俄文，英文用户可能缺少关键安装与限制说明。
- n8n 节点存在 V1/V2 兼容映射与别名操作，升级时需注意参数重命名风险。