SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI聊天助手cognigy-ai-mcp-management-server

cognigy-ai-mcp-management-server

这是一个面向 Cognigy.AI 对话式 AI 平台的本地 MCP（模型上下文协议）服务器，提供 132 个工具，让 Claude、Cursor 等 AI 助手通过自然语言以编程方式构建、配置、测试和运营 Cognigy.AI 虚拟代理。功能涵盖流程、节点和意图的创建与管理，NLU 训练与回归测试，快照和包的多环境部署，以及 LLM、Knowledge AI 和集成的配置。它需要自带有效的 Cognigy.AI 账户与 API Key，且非 Cognigy/NiCE 官方或关联项目。所有变更类工具默认使用 dryRun: true 保证安全，长时操作自动轮询至完成，API Key 仅存于内存且密钥自动脱敏，列表操作支持分页。适合在 Cognigy.AI 上构建对话式 AI 的开发者、解决方案架构师和系统集成伙伴。

访问官网

工具介绍

用途

cognigy-ai-mcp-management-server 是一个本地 MCP 服务器，用于通过 Cognigy.AI 的 Management API 管理 Cognigy.AI 虚拟代理。它让 AI 编程助手（如 Claude、Cursor 等）能够以编程方式构建、配置、测试和运营 Cognigy.AI 对话式 AI 代理，从而替代在 Cognigy UI 中手动点击操作。

该服务器为独立开源项目，与 Cognigy 或 NiCE 无隶属、背书或赞助关系。使用它需要你自己的有效 Cognigy.AI 账户和 API Key，并遵守 Cognigy 的商业许可条款。“Cognigy”和“Cognigy.AI”是其各自所有者的商标。

目标用户：在 Cognigy.AI 上进行开发的开发者、解决方案架构师和系统集成（SI）伙伴。

主要能力

通过自然语言，你可以完成：

  • 创建和管理流程（flows）、节点（nodes）和意图（intents）
  • 自动运行 NLU 训练和回归测试
  • 跨环境部署快照（snapshots）和包（packages）
  • 配置 LLM、Knowledge AI 和集成

服务器共提供 132 个 MCP 工具，按领域组织。其安全与运行特性包括：

  • 默认安全：所有变更类工具默认使用 dryRun: true
  • 异步感知：长时间运行的操作会轮询直至完成
  • 安全：API Key 仅保存在内存中，密钥会被自动脱敏
  • 分页：所有列表操作支持 limit 和 skip

使用方式

前置条件

  • Node.js 20.0.0 或更高版本
  • 拥有 API 访问权限的 Cognigy.AI 账户（Trial、SaaS 或本地部署）
  • 从 Cognigy UI 生成的 API Key（My Profile → API Keys）

重要：@cognigy/rest-api-client 包采用“Cognigy Proprietary License”许可。安装该包即表示你同意 Cognigy 的许可条款。

配置环境变量

运行前需设置环境变量，包括常见 Base URL 等（具体变量名与取值请参照项目文档）。

MCP 客户端配置

  • macOS：添加到 ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：添加到 %APPDATA%\Claude\claude_desktop_config.json
  • 在项目根目录的 .mcp.json 中添加
  • 在 .cursor/mcp.json 中添加

安装与依赖

该包要求 @cognigy/rest-api-client 作为同伴依赖（peer dependency），这意味着：

  • 你必须单独安装它
  • 安装 Cognigy 的包即表示你接受 Cognigy 的许可条款
  • 本项目不打包或再分发任何 Cognigy 代码

你需要自行负责：

  • 审阅并接受 Cognigy 的专有许可条款
  • 拥有使用 Cognigy API 的适当权利
  • 确保 API 凭证安全

Cognigy REST API 客户端是由 Cognigy GmbH 维护的官方 SDK，以“Cognigy Proprietary License”发布在 npm 上。

开发与测试

项目包含实时 API 测试与可选类型再生成步骤（当需要从更新的 Cognigy API 更新生成的类型时）。本 MCP 服务器基于 MIT 许可证发布，详见 LICENSE。注意：MIT 许可证仅适用于本 MCP 服务器代码，依赖（尤其是 @cognigy/rest-api-client）受其各自许可证约束。

贡献指南：Fork 仓库、创建功能分支（git checkout -b feature/amazing-feature）、遵循现有代码模式（Zod schemas、dryRun 标志等）、为新工具添加测试、在提交前运行 npm test && npm run build，然后提交 Pull Request。

开发准则：所有工具必须有 Zod 输入验证；变更类工具必须支持 dryRun 标志（默认 true）；工具描述应便于 LLM 理解（1-2 句话）；绝不记录或暴露 API Key/密钥；先针对 mock 服务器测试再对接实时 API。

适用场景

  • 开发者、解决方案架构师和 SI 伙伴在 Cognigy.AI 上构建对话式 AI 代理
  • 希望用自然语言代替 UI 点击来管理流程、节点和意图
  • 需要自动运行 NLU 训练和回归测试
  • 需要跨环境部署快照和包
  • 需要配置 LLM、Knowledge AI 和集成

限制

  • 需要你自己的有效 Cognigy.AI 账户和 API Key
  • 非 Cognigy/NiCE 官方或关联项目，不提供官方支持
  • 使用受 Cognigy 商业许可条款约束，@cognigy/rest-api-client 为专有许可
  • 本服务器代码为 MIT 许可，但依赖受其各自许可约束
  • 相关资料未提供具体收费、价格与效果数据

同类工具

查看分类