CliDeck MCP — Network Knowledge

com.clideck由 clideck.com 发布官方发布者v0.8.5更新于 Nov 9, 2026

Free verified network knowledge for AI agents: deterministic answers, honest unknowns.

已验证Streamable HTTP可网页运行云端与基础设施知识与记忆安全与监控

概览

AI 生成的概览

远程 MCP 端点，为助手提供确定性的、按版本限定的网络知识：命令、诊断、工作流、变更审查与专家研究任务。

可以做什么
  • 解析厂商、型号、操作系统与版本上下文，再查询按版本限定的命令、诊断与概念
  • 列出并描述已安装的知识域包，并在单个域内执行确定性检索
  • 获取含安全、验证与回滚步骤的有序工作流，以及知识修订的来源元数据
  • 审查并验证拟议的网络变更、给出升级建议，分析设备快照或路径与拓扑输出
  • 上报知识缺口、提交反馈，并创建、轮询、补充或取消专家研究任务
适用场景
当助手需要有来源、与具体版本对应的网络指导（设备命令、排障、变更审查、升级规划），且应回答“未知”而非猜测时适用。也适合希望把知识库缺口转为研究任务的团队。
运行要求
需要一个指向托管端点的 Streamable HTTP MCP 客户端；未声明认证、环境变量或请求头。本地运行开源版本需要 Node.js 24、pnpm 与 PostgreSQL 16。
安装前请注意
该服务仅提供建议，从不连接设备或执行命令。设备快照与路径输出据称会脱敏且不存储，但仍会发送给第三方服务。查询与缺口上报会创建被跟踪的研究需求，专家任务会返回需保密的访问令牌。覆盖范围因厂商、平台和版本而异。

安装

在 SourceWeft 中

  1. 打开 控制台中的 CliDeck MCP — Network Knowledge，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.clideck%2Fnetwork-knowledge/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "clideck-network-knowledge": {
      "type": "http",
      "url": "https://mcp.clideck.com/mcp"
    }
  }
}

README

CliDeck MCP

An open-source framework for version-aware, source-backed knowledge that AI agents query through MCP. Known answers use deterministic PostgreSQL retrieval; incomplete answers create durable research demands. Isolated Codex runs discover and extract evidence; the core validates and publishes immutable revisions. CliDeck provides guidance and never connects to devices or executes commands.

SurfaceURL
Public Streamable HTTP MCPhttps://mcp.clideck.com/mcp
Network Evidence Workbenchhttps://mcp.clideck.com/webmcp
Live read-only operations demohttps://mcp.clideck.com/demo
Product pagehttps://clideck.com/software/mcp

Capabilities

  • Network Knowledge: device context, commands, workflows, snapshots and redaction, change review, verification, upgrades, topology and expert tasks. Exact context ranks first; broader guidance is labelled and unsupported questions remain unknown. Coverage varies by vendor, platform and version.
  • Domain Packs: subject-specific schemas and deterministic validation over the shared revision/release core. Engineering Measurements demonstrates exact decimal values, units and tolerances outside networking.
  • Continuous research: 1–8 enabled isolated executors, independent Luna/High models and official price comparison in /admin/models; downloads, conversion, OCR, chunking, indexing and publication are mechanical. AI receives bounded tasks through the researcher bridge. See model policy.
  • WebMCP: six typed browser tools share a versioned case with the engineer. Complete files stay local; selected evidence is redacted before transmission. Browser-agent evidence access requires explicit opt-in. Manual controls work without WebMCP. See contract and walkthrough.
  • Operations demo: /admin and /demo use the same frontend and real production counters. Server-side projections redact private data; demo controls cannot mutate production.

[Production operations dashboard]

Live totals are available in the demo and /public/v1/stats; historical counts and test results are not current service guarantees. Codex was the primary engineering environment. Pipeline use through a local authenticated Codex installation needs no separate model API integration and remains subject to plan and usage limits.

Run locally

Requirements: Node.js 24, pnpm as pinned in package.json, PostgreSQL 16 (Docker Compose is provided).

bash
cp .env.example .envset -asource .envset +apnpm install --frozen-lockfiledocker compose up -d postgrespnpm db:migratepnpm db:seedpnpm knowledge:reindex-applicability -- --resume --verifypnpm buildpnpm dev:api

Edit .env for your local database before sourcing it. MCP listens at http://127.0.0.1:8787/mcp. Worker/researcher entry points and all supported commands are in package.json. Production uses the canonical deployment workflow.

To connect the hosted service with the Codex CLI:

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

Other Streamable HTTP MCP clients can use the same endpoint.

Develop

bash
pnpm checkpnpm testpnpm evalpnpm build

PostgreSQL integration tests and the 250-case evaluation need a migrated, seeded test database. A run that skips DB tests is not full release validation; the deploy script provisions its own disposable database and applies grants.

Create a pack:

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

See agent rules, documentation map, architecture, pack authoring and security.

License and privacy

Apache-2.0 covers code and project-authored fixtures, not production knowledge, third-party manuals or user data. Internal evidence and secrets stay private. The dedicated provenance tool exposes only allowlisted metadata for active revisions; the operations demo retains its stricter redaction boundary. See DATA-NOTICE.md.

来源：README.md，提交 828aa3b

工具

20

report_knowledge_gap

Report an Incomplete or Incorrect Answer

Record the original network question for priority research. Provide missing context or explain why an answer was not useful. Feedback alone does not change or quarantine published knowledge.

输入参数reason必填contextquestion必填revision_refs

report_domain_knowledge_gap

Report an Incomplete Technical Answer

Retain the original technical question, independent OS/component versions and missing details for priority learning. Does not alter published revisions.

输入参数reason必填context必填question必填domain_id必填revision_refs

get_learning_status

Get Learning Progress

Check a learning ID returned by a knowledge query or report_knowledge_gap. Published means the original question has a complete answer; repeat the original query to read it.

输入参数learning_id必填

list_knowledge_domains

List Knowledge Domains

List installed, compatible knowledge domain packs and their declared capabilities.

无需输入参数。

describe_knowledge_domain

Describe Knowledge Domain

Return the context and public-record contracts for one installed knowledge domain.

输入参数domain_id必填

query_domain_knowledge

Query Domain Knowledge

Run deterministic search in one domain using that pack’s validated context and public-record schema. Network queries may create or update a tracked research demand for missing or incomplete knowledge.

输入参数limitcontext必填question必填domain_id必填

resolve_network_context

Resolve Network Context

Resolve vendor, model/platform, portable software family, operating system, and version context.

输入参数modelvendorversionruntime_modeoperating_systemshell_environment

query_network_knowledge

Query Network Knowledge

Return deterministic, version-scoped commands, diagnostics, and concepts for a network question. Missing or incomplete knowledge may create or update a tracked research demand. No device commands are executed.

输入参数limitcontext必填question必填

get_knowledge_provenance

Get Knowledge Provenance

Return safe source metadata for up to five active knowledge revisions.

输入参数revision_refs必填

get_network_workflow

Get Network Workflow

Return a deterministic, ordered workflow including safety, verification, and rollback. Missing or incomplete knowledge may create or update a tracked research demand. No device commands are executed.

输入参数goal必填limitcontext必填

request_expert_answer

Request Expert Answer

Create a durable research task when deterministic knowledge has no applicable answer.

输入参数context必填question必填idempotency_key

get_expert_task

Get Expert Task

Poll an expert research task by opaque ID and access token.

输入参数task_id必填access_token

continue_expert_task

Continue Expert Task

Provide bounded additional input requested by the researcher.

输入参数message必填task_id必填access_token

cancel_expert_task

Cancel Expert Task

Cancel a non-terminal expert task.

输入参数task_id必填access_token

submit_feedback

Submit Feedback

Submit correctness, freshness, safety, or completeness feedback without including private logs.

输入参数ratingcommenttask_idcategory必填access_tokenrevision_refsample_contribution

analyze_device_snapshot

Analyze Device Snapshot

Detect vendor, model, operating system, and version from bounded CLI output while redacting sensitive values. Input is not stored.

输入参数snapshot必填snapshot_typeredaction_profile

review_network_change

Review Network Change

Deterministic advisory review of commands or a configuration diff. It always returns available guidance and never executes a command. Missing or incomplete knowledge may create or update a tracked research demand.

输入参数intent必填context必填commandsconfig_diff

verify_network_change

Verify Network Change

Evaluate bounded before/after outputs against the signed verification plan returned by review_network_change.

输入参数after_snapshot必填before_snapshot必填verification_token必填

advise_network_upgrade

Advise Network Upgrade

Return exact-model, exact-version upgrade prerequisites, risks, checks, and rollback without downloading software. Missing or incomplete knowledge may create or update a tracked research demand. No device commands are executed.

输入参数model必填target_version必填current_version必填enabled_featuresoperating_system

analyze_network_path

Analyze Network Path

Build a bounded topology and packet-path graph from supplied CDP, LLDP, route, and traceroute outputs without storing them.

输入参数sourcesnapshots必填destination

版本历史

1
  1. v0.8.5最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分