CliDeck MCP — Network Knowledge

CliDeck MCP

一个开源框架，用于提供具备版本感知能力、以来源为依据的知识，供 AI Agent 通过 MCP 查询。已知答案使用确定性的 PostgreSQL 检索；不完整的答案会生成持久的研究需求。相互隔离的 Codex 运行会发现并提取证据；核心系统负责验证并发布不可变修订版。 CliDeck 提供指导，绝不会连接设备或执行命令。

界面	URL
公共 Streamable HTTP MCP	https://mcp.clideck.com/mcp
网络证据工作台	https://mcp.clideck.com/webmcp
实时只读操作演示	https://mcp.clideck.com/demo
产品页面	https://clideck.com/software/mcp

功能

• 网络知识： 设备上下文、命令、工作流、快照与脱敏、变更审查、验证、升级、拓扑和专家任务。 精确上下文优先；更宽泛的指导会明确标注，不受支持的问题则保持为 unknown。覆盖范围因供应商、平台和版本而异。
• 领域包： 基于共享的修订版／发布核心，提供特定主题的架构和确定性验证。工程测量展示了网络领域之外的精确十进制数值、单位和公差。
• 持续研究： 1–8 个已启用的隔离执行器、独立的 Luna/High 模型，以及 /admin/models 中的官方价格比较；下载、转换、OCR、分块、索引和发布均为机械化流程。AI 通过研究人员桥接程序接收有界任务。参见模型策略。
• WebMCP： 六个类型化浏览器工具与工程师共享一个带版本的案例。 完整文件保留在本地；传输前会对选定证据进行脱敏。 浏览器 Agent 访问证据需要明确选择启用。无需 WebMCP 也可使用手动控制。参见协议与演练。
• 操作演示： /admin 和 /demo 使用相同的前端和真实的生产计数器。服务器端投影会对私有数据进行脱敏；演示控制无法修改生产环境。

演示和 /public/v1/stats 中提供实时总数；历史计数和测试结果并非当前服务保证。Codex 是主要的工程环境。通过本地已认证的 Codex 安装使用流水线，无需单独集成模型 API，但仍受计划和使用限制约束。

本地运行

要求：Node.js 24、package.json 中固定的 pnpm 版本、PostgreSQL 16（提供 Docker Compose）。

cp .env.example .env
set -a
source .env
set +a
pnpm install --frozen-lockfile
docker compose up -d postgres
pnpm db:migrate
pnpm db:seed
pnpm knowledge:reindex-applicability -- --resume --verify
pnpm build
pnpm dev:api

在加载 .env 之前，请编辑该文件以配置本地数据库。MCP 监听地址为 http://127.0.0.1:8787/mcp。工作器／研究人员入口点和所有受支持的命令都在 package.json 中。生产环境使用 规范部署工作流。

要使用 Codex CLI 连接托管服务：

codex mcp add clideck --url https://mcp.clideck.com/mcp
codex mcp list

其他 Streamable HTTP MCP 客户端也可以使用相同的端点。

开发

pnpm check
pnpm test
pnpm eval
pnpm build

PostgreSQL 集成测试和 250 个案例的评估需要已迁移并填充种子数据的测试数据库。跳过数据库测试的运行不属于完整的发布验证；部署脚本会配置自己的临时数据库并应用授权。

创建一个包：

pnpm domain:create -- --id marine-science --name "Marine Science"
pnpm install --lockfile-only
pnpm domain:validate -- --id marine-science
pnpm --filter @clideck/domain-marine-science test

参见Agent 规则、文档索引、 架构、包编写指南 和安全。

许可证与隐私

Apache-2.0 适用于代码和项目编写的测试样例，不适用于生产知识、 第三方手册或用户数据。内部证据和机密信息均保持私密。 专用的来源信息工具仅公开活动修订版的允许列表元数据；操作演示采用更严格的数据脱敏边界。 参见 DATA-NOTICE.md。