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 分