Claims Mcp

io.github.dgonzap30由 GitHub 帳號 dgonzap30 發布v0.1.0更新於 Oct 24, 2026

A claims memory for agents: assert beliefs, let them decay, surface contradictions.

已驗證STDIO僅桌面知識與記憶AI 與機器學習

概覽

AI 產生的概覽

一個給代理用的本機宣告記憶，用來存放關於實體的信念，隨時間衰減，並標出過期或互相矛盾的宣告。

可以做什麼
以實體為單位儲存宣告，每筆宣告帶有類型、波動性、信心度與狀態，並讓助理新增、搜尋、確認或撤回宣告。宣告依波動性設定的半衰期衰減，未重新確認時有效信心度會持續下降。相關工具會列出過期宣告，以及重複優先順序排名、狀態衝突等矛盾，另有一個資源以 JSON 形式回傳全部宣告。
適用情境
適合需要一份會隨時間老化的信念記憶的情境，例如跨工作階段追蹤優先順序、狀態或關係，並察覺它們何時過期或衝突。最適合單一使用者的本機工作流程，且觀測資料由助理自行提供。
執行需求
以本機 stdio 程序在使用者機器上執行，透過 npm 套件 claims-mcp 安裝並以 bunx 啟動。需要 Bun 1.1 或更新版本，因為它使用 bun:sqlite 而非一般 Node。資料存放在本機單一 SQLite 檔案 ~/.claims-mcp/claims.db，可用 --db 或環境變數 CLAIMS_MCP_DB 覆寫。不需要網路、帳號或 API 金鑰。
安裝前請注意
它會寫入本機 SQLite 資料庫，宣告可被新增、更新、確認或停用並跨工作階段保留。資料庫路徑可透過 CLAIMS_MCP_DB 或 --db 變更，請指向你預期的位置。不要求任何憑證或網路存取，用於排名下降檢查的觀測資料由呼叫方提供，而非自行蒐集。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Claims Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

claims-mcp

A small memory for agents that treats what it knows as claims that age. You assert a claim about an entity ("acme is priority #1", "the launch is on track"), each claim decays on a half-life set by how volatile it is, and the server tells you which claims have gone stale and which contradict each other.

It is a stdio MCP server plus a CLI over one local SQLite file. No network, no accounts.

Runtime: Bun. v0 uses bun:sqlite, so it runs on Bun ≥ 1.1, not plain Node. A Node build (node:sqlite) is a possible follow-up.

Model

FieldMeaning
entityWhat the claim is about (free text key).
kindpriority (may carry assertedRank), status, fact, relationship.
volatilitystable (half-life 365d), slow (30d), volatile (7d).
confidence0..1 at last confirmation. Effective confidence halves every half-life since lastConfirmed, floored at 0.05.
stateactive, stale, contradicted, retired. Only active claims are checked.

A claim's identity is (entity, kind, claim): asserting it again updates it rather than duplicating.

MCP tools

ToolDoes
claim_addAssert or update a claim.
claim_searchCase-insensitive substring search over claim text and entity.
claim_confirmRe-confirm now: resets decay, reactivates, optionally sets confidence.
claim_retractRetire a claim.
claims_contradictionsConflicts among active claims: duplicate-rank (two entities claim the same priority rank), status-conflict (several active status claims for one entity). Pass observed weekly ranks to also get rank-drop: an asserted-priority entity that every signal ranks worse than rank + 2 for 3 valid periods.
claims_decayedActive claims past a staleness threshold (default 0.5), stalest first.

Resource: claims://all (every claim as JSON).

observed is { "signals": [{ "<entity>": [rank_now, rank_1_period_ago, ...] }, ...], "validPeriods": [true, ...] }. You supply the observations (commit counts, time spent, anything you can rank); the server does not collect them.

Use

bash
bun install

Add to an MCP client (Claude Code shown):

bash
claude mcp add claims -- bun /path/to/claims-mcp/src/mcp.ts

The database lives at ~/.claims-mcp/claims.db; override with --db <path> or CLAIMS_MCP_DB.

CLI:

bash
bun src/cli.ts add acme priority slow 0.8 "acme comes first" --rank 1bun src/cli.ts search comesbun src/cli.ts stale 0.5bun src/cli.ts contradictionsbun src/cli.ts confirm <id>bun src/cli.ts retract <id>

Development

bash
bun test          # 19 tests, synthetic claims onlybun run typecheckbun run audit     # publish gate: home paths, private names, secret patterns

Set AUDIT_TERMS="name1|name2" to add your own private names to the audit.

Provenance

Not a straight extraction. The decay curve and the rank-drop rule are ported from a personal agent memory (rank-drop now takes caller-supplied observations); the duplicate-rank and status-conflict rules are new claim-vs-claim logic written for this package. It shares no code, data or storage with the original.

Author

Built by Diego González Zapiain at Lojik Labs. Listed on the official MCP Registry as io.github.dgonzap30/claims-mcp.

Licence

MIT

來源：README.md，提交 66c1df8

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 20, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分