ColdState — Deterministic Knowledge Infrastructure

Deterministic knowledge for AI agents: search, fetch, cite and verify a 48M-entry knowledge base.

我该使用它吗

质量与安全性

A
描述质量
98%
模式完整度
82%
命名质量
80%
投毒风险
100%
权限匹配度
100%
协议合规性
100%

发现(1)

  • LOWTool 'coldstate_browse_documents' description lacks action verb在 coldstate_browse_documents 中

基于对工具定义和协议合规性的自动分析。

上下文开销

~2,545token 数(工具定义)
~915 B典型响应大小
对注意力有中等影响(占 128k 上下文窗口的 1.99%)

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。

安装

一键安装

将以下内容添加到你的 `claude_desktop_config.json` 文件中:

{
  "mcpServers": {
    "knowledge": {
      "url": "https://cold-api.coldstate.ai/mcp"
    }
  }
}

远程端点

https://cold-api.coldstate.ai/mcpstreamable-http

它能做什么

工具清单

工具(16)

🟢 只读🟡 写入🔴 删除⚪ 未知
🟢coldstate_search(query, collection, index_id, limit, offset)

Search a ColdState index by collection name or index ID. Returns ranked results with Ψ scores and state classification (CRYSTALLINE/FLUID/REACTIVE/DECOHERENT). Provide exactly one of `collection` or `index_id`.

输入模式

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The search query"
    },
    "collection": {
      "description": "Collection name to search (mutually exclusive with index_id)",
      "type": "string"
    },
    "index_id": {
      "description": "Index ID to search, e.g. idx_... (mutually exclusive with collection)",
      "type": "string",
      "pattern": "^idx_[a-f0-9]+$"
    },
    "limit": {
      "default": 10,
      "description": "Max results to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Offset for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_list_indexes

List all your ColdState indexes with their status, mode, document count, and domain preset.

输入模式

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_browse_documents(index_id, limit, offset)

Browse documents in a ColdState index. Indexes are zero-knowledge, so each document is returned as your ref_id plus its state classification and E-score — no stored text. Map ref_id back to your own content.

输入模式

{
  "type": "object",
  "properties": {
    "index_id": {
      "type": "string",
      "pattern": "^idx_[a-f0-9]+$",
      "description": "Index ID, e.g. idx_..."
    },
    "limit": {
      "default": 20,
      "description": "Max documents to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Offset for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "index_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_explain(index_id, query, doc_id)

Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.

输入模式

{
  "type": "object",
  "properties": {
    "index_id": {
      "type": "string",
      "pattern": "^idx_[a-f0-9]+$",
      "description": "Index ID, e.g. idx_..."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The search query to explain against"
    },
    "doc_id": {
      "type": "string",
      "pattern": "^\\d+$|^doc_\\d+$",
      "description": "Document ID, e.g. \"doc_42\" or \"42\""
    }
  },
  "required": [
    "index_id",
    "query",
    "doc_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_search_global(query, domain, limit, offset)

Search ColdState's global knowledge base (48.4M+ entries across 35 domains including SCIENCE, MEDICINE, TECHNOLOGY, HISTORY, etc). Returns deterministically ranked results with Ψ relevance scores and a state classification. Optionally filter by domain.

输入模式

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The search query"
    },
    "domain": {
      "description": "Filter by knowledge domain (e.g. MEDICINE, SCIENCE, TECHNOLOGY, HISTORY, LAW, CODE). Case-insensitive.",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "description": "Max results to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Offset for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_domains

List all available knowledge domains in ColdState's global knowledge base with entry counts.

输入模式

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_fetch(id)

Fetch a single knowledge-base entry verbatim by its stable id (e.g. "eng_000229f438f7cebd"). Deterministic retrieval — returns the full record plus a content_hash and kb_snapshot for reproducible citation.

输入模式

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Stable knowledge entry id, e.g. eng_... or soc_..."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_cite(id)

Get a canonical, reproducible citation for a knowledge entry by id (title, domain, source, content_hash, kb_snapshot). Cite a fact so it can be re-verified later with coldstate_verify.

输入模式

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Stable knowledge entry id"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_verify(id, content_hash)

Verify a previously-cited knowledge fact is unchanged. Provide the entry id and the content_hash you stored earlier; returns whether it still matches the current knowledge base. The trust primitive for AI-to-AI fact-checking.

输入模式

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Stable knowledge entry id"
    },
    "content_hash": {
      "type": "string",
      "minLength": 8,
      "maxLength": 64,
      "description": "The content_hash from a previous fetch/cite"
    }
  },
  "required": [
    "id",
    "content_hash"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_snapshot

Get the current knowledge-base snapshot/version id. Pin this kb_snapshot for reproducibility: the same query against the same kb_snapshot returns identical results.

输入模式

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_related(id, limit)

Find knowledge entries deterministically related to a given entry id via ColdState's concept-cluster graph. Returns same-cluster and neighboring-cluster entries, each tagged with its relation and a cross_domain flag. Same id ⇒ same neighbors.

输入模式

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Stable knowledge entry id, e.g. eng_... or soc_..."
    },
    "limit": {
      "default": 10,
      "description": "Max related entries",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_resolve(query, limit)

Resolve a name, alias, or surface form to its canonical ColdState knowledge entry (id + title). Deterministic: an exact title match wins, else the top relevance-Ψ entry. Returns the canonical entry plus alternatives. Use the returned id with coldstate_fetch / coldstate_related.

输入模式

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "The name/term/alias to resolve"
    },
    "limit": {
      "default": 4,
      "description": "Max alternative candidates",
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_batch_search(queries, domain, limit)

Run several knowledge-base queries in one call against a single consistent kb_snapshot. Returns each query with its ranked results — efficient and snapshot-consistent across the whole batch.

输入模式

{
  "type": "object",
  "properties": {
    "queries": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 2000
      },
      "description": "1–10 queries"
    },
    "domain": {
      "description": "Optional domain filter applied to all queries",
      "type": "string"
    },
    "limit": {
      "default": 5,
      "description": "Max results per query",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "queries"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_stats(query, domain)

Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).

输入模式

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Optional query to get coverage/state stats for",
      "type": "string",
      "maxLength": 2000
    },
    "domain": {
      "description": "Optional domain filter (with query)",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_capabilities

Machine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits. Call this first to self-configure.

输入模式

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢coldstate_isomorph(id, limit)

Cross-domain structural analog: given a knowledge entry id, find its closest structural twin in each OTHER domain ("same structure, different domain"). Deterministic. Use coldstate_resolve to turn a name into an id first.

输入模式

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Stable knowledge entry id, e.g. eng_... or soc_..."
    },
    "limit": {
      "default": 8,
      "description": "Max cross-domain analogs (one per domain)",
      "type": "integer",
      "minimum": 1,
      "maximum": 35
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

社区

评价此服务器

证据

最近观测

已验证未记录版本16 个工具