privacyops

PrivacyOps

由 Seaynic Labs 制作。 想要围绕你自己的系统构建这样的工具？我们可以帮你实现。

PrivacyOps 可让 AI 助手跟踪你的信用报告异议并起草异议信函，每条记录都保存在你自己电脑上的文件中。它会计算每项待处理异议的法定回复期限，并提供相关技能，指导你完成从收集事实到后续跟进的整个异议流程。

这不是法律建议。 PrivacyOps 是一款跟踪和起草辅助工具。它不了解你的具体情况，也不了解你所在州的法律。这些信函模板未经律师审阅。 如有法律问题，请咨询律师或消费者保护机构。

安全信息
网络	无。PrivacyOps 不会发起任何出站网络请求，也不收集遥测数据。只有 --transport http 会启动监听器，除非你更改 --host，否则监听地址为 127.0.0.1。
文件	读取其配置文件（如果存在，则为 ~/.config/privacyops/config.toml）。在其数据文件夹（~/.local/share/privacyops）中读取和写入记录文件及信函文本文件，仅所有者可访问。每次批准决定都会在 ~/.local/state/privacyops/approvals.jsonl 中追加一行（仅含 ID）。
密钥	PrivacyOps 不存储密码或 API 密钥，也没有任何需要此类信息的工具。它绝不会索要社会安全号码。
只读工具	5 个：disputes_list、disputes_get、disputes_deadlines、letters_templates、privacyops_modules
在此电脑上写入	disputes_create、disputes_update、letters_generate：仅操作本地文件，无需批准。每项异议变更都会记录在其历史记录中。
需要你批准	disputes_delete：你需要在应用中逐项批准删除，或在设置中预先批准。AI 不能代你批准。
启动开销	约 5,900 个 token（9 个工具、2 个技能提示词）
变更	工具描述通过哈希锁定（tool-manifest.lock.json）；如果描述发生未显式声明的更改，CI 会失败。

这是一个工具包：工具、技能和说明集中在一次安装中。这些工具构成一个由多个模块组成的服务。你可以启用所需模块。新模块默认关闭，因此更新不会在你主动选择之前改变助手的能力。

模块	功能	状态
disputes	跟踪与消费者报告机构（Equifax、Experian、TransUnion）及信息提供方（向这些机构报送信息的公司）之间的异议：状态、寄出日期、回复期限和变更历史	0.2
letters	使用两种固定模板起草异议信函，并以文本文件形式保存在你的电脑上	0.1

计划中但尚未构建：数据经纪商退出选项和信用冻结工具。这些只是构想，并非承诺。

适用人群： 希望自行记录异议并获得清晰信函的消费者。PrivacyOps 不适用于律师、信用修复企业，也不适用于任何处理他人身份信息的人。

技能

技能是简短的指南，助手会在执行任务前阅读。PrivacyOps 提供两种技能，并以两种形式从同一来源生成：供支持 Agent Skills 的应用（Claude Code 等）使用的 skills/ 文件夹，以及供其他所有 MCP 应用使用的 MCP 提示词。

技能	内容	作者
getting-started	设置、数据文件夹、设置选项、--doctor 和错误读取	Seaynic Labs，MIT
dispute-walkthrough	收集事实、选择机构或公司处理途径、认证邮件、期限、后续跟进以及何时寻求帮助	Seaynic Labs，MIT

PrivacyOps 不附带任何第三方技能。请参阅 CREDITS.md。

哪些内容会留在你的电脑上

• 争议记录保存在数据文件夹中的一个 JSON 文件里。默认路径：~/.local/share/privacyops/privacyops.json。设置 PRIVACYOPS_DATA_DIR 可选择其他文件夹。
• 信件以 Markdown 文本文件的形式保存在该文件夹中的 letters/ 目录里。
• 删除操作的审批决定会追加到 ~/.local/state/privacyops/approvals.jsonl：仅包含 ID 和决定。
• 不会向 Seaynic Labs 或任何其他服务发送任何内容。PrivacyOps 不会发起任何出站网络请求。
• 创建的文件只有你本人可以读取（权限模式为 0600），但不会加密。任何能够访问你账户的人都可以读取这些文件。请勿将该文件夹放在你无法控制的共享文件夹或同步文件夹中。
• 你的 AI 助手可以看到你在聊天中输入的内容，运行它的公司也能看到。PrivacyOps 无法改变这一点。

PrivacyOps 绝不会索要社会安全号码。 如果信用机构要求提供身份识别号码，请亲自在打印出的信件上填写。

安装

PrivacyOps 需要 Python 3.11 或更高版本。使用 uv 时，无需预先安装任何内容：

uvx privacyops-mcp --version
uvx privacyops-mcp --doctor          # checks your data folder and records, prints fixes

如果希望仅在你选择时才更新，可以固定到确切版本：uvx privacyops-mcp==0.2.2。

也可以使用 pip：

pip install privacyops-mcp

作为 Claude Code 插件（只需一步即可安装服务和技能；前提是 seayniclabs/plugins 市场中已列出 PrivacyOps）：

/plugin marketplace add seayniclabs/plugins
/plugin install privacyops@seayniclabs

使用 pip uninstall privacyops-mcp 卸载时，只会移除程序。**你的记录和信件仍保留在数据文件夹中。**如果想将它们删除，请自行删除该文件夹。

设置

PrivacyOps 无需任何设置即可启动。默认设置是安全的。

变量	模块	作用
PRIVACYOPS_DATA_DIR	all	保存记录和信件的文件夹。默认路径 ~/.local/share/privacyops
PRIVACYOPS_DISPUTES_ALLOW_DELETE	disputes	默认值为 false：每次删除都需要你批准。设为 true 后，助手无需询问即可删除争议记录。
PRIVACYOPS_APPROVAL_LOG	all	审批日志的路径。默认路径 ~/.local/state/privacyops/approvals.jsonl
PRIVACYOPS_<MODULE>_ENABLED	any	设为 false 可关闭某个模块，例如 PRIVACYOPS_LETTERS_ENABLED=false

**配置文件（可选）。**PrivacyOps 也会读取 ~/.config/privacyops/config.toml，或 PRIVACYOPS_CONFIG 指定的文件。环境变量的优先级高于配置文件。

data_dir = "/Users/you/Documents/privacyops"

[disputes]
allow_delete = false

[letters]
enabled = true

将其添加到 MCP 客户端

大多数客户端使用相同的 JSON 格式。将其放在客户端存放 MCP 服务配置的位置：

{
  "mcpServers": {
    "privacyops": {
      "command": "uvx",
      "args": ["privacyops-mcp"],
      "env": {
        "PRIVACYOPS_DATA_DIR": "/Users/you/Documents/privacyops"
      }
    }
  }
}

客户端	配置位置
Claude Desktop	claude_desktop_config.json（Settings → Developer → Edit Config）
Claude Code	claude mcp add privacyops -- uvx privacyops-mcp，或项目中的 .mcp.json
Cursor	~/.cursor/mcp.json，或项目中的 .cursor/mcp.json
VS Code	.vscode/mcp.json，使用 "servers" 而非 "mcpServers"
Sonique、Hermes、OpenClaw 等	任何可启动 stdio MCP 服务的客户端：命令为 uvx，参数为 ["privacyops-mcp"]，并附上 env 值

**通过 HTTP 连接。**适用于连接 URL 而非启动进程的客户端：

privacyops-mcp --transport http --port 8765

它会在 http://127.0.0.1:8765/mcp 提供可流式传输的 HTTP 服务，默认仅监听本机。若要将其暴露到其他位置，请先在其前面设置身份验证。

试试这些

设置好 PrivacyOps 后，将以下任意一句粘贴到助手中：

1. “就一笔我按时支付却被标记为逾期的款项，向 Experian 提出争议并起草信件。暂时不要发送任何内容。”
2. “我的哪些争议已逾期？接下来我该怎么做？”
3. “一步一步教我如何对信用报告中的一条记录提出争议。”
4. “告诉我争议记录存放在哪里，以及文件中包含什么内容。”
5. “删除这家发卡机构对应的争议记录，但先向我展示预览。”

工具

工具	返回内容
privacyops_modules	哪些模块已启用、每个工具的功能、数据所在位置、技能和免责声明。请先调用此工具。
disputes_list	争议摘要，可按状态或当事方类型筛选，并通过 offset 分页
disputes_get	单个争议及其详细信息、截止日期、已撰写的信函和历史记录
disputes_deadlines	未结争议及各自的法定回复期限、剩余天数、逾期标记、下一步行动，以及无法得知的事实
disputes_create	开始跟踪一项争议
disputes_update	更改状态、设置寄出日期或添加备注。每次更改都会记录在历史记录中。
disputes_delete	删除一条争议记录。请先预览；删除需经你批准。信函文件不会删除。
letters_templates	模板、已核实联系方式的机构，以及免责声明
letters_generate	将信函写入文本文件。如果你提供争议 ID，还会将信函附加到该争议。

每个工具都会返回带有已发布架构的结构化数据。错误格式为 privacyops.<module>.<code>: <message> Fix: <hint>。

回复期限

disputes_deadlines 根据你记录的寄出日期，计算法规规定的期限：

• 消费者报告机构： 该机构必须在收到你的争议后 30 天内重新调查，15 U.S.C. 1681i(a)(1)(A)。只有在你于这 30 天内发送相关信息时，它才可将期限延长最多 15 天；如果它在该期限内认定该条目不准确或无法核实，则不得延长，1681i(a)(1)(B)–(C)。来源：https://www.law.cornell.edu/uscode/text/15/1681i
• 信息提供方（报告该条目的公司）： 必须在 1681i(a)(1) 规定的期限结束前调查并答复直接提交的争议，15 U.S.C. 1681s-2(a)(8)(E)(iii)。由机构转交的争议适用 1681s-2(b)(2)。来源：https://www.law.cornell.edu/uscode/text/15/1681s-2

该工具从你记录的寄出日期开始计算。法规规定从对方收到争议的当天开始计算，因此实际期限相同或更晚。该工具不知道信件何时送达、你是否发送了额外信息，也不知道信息提供方争议走的是哪种途径，因此会在每一行说明这些情况，而不会猜测。我们已于 2026-10-27 根据官方文本核对这些期限。

信函模板和来源

两个模板均为固定文本，不由模型生成。我们已于 2026-10-27 根据官方法规文本核对每一项引用。

模板	用途	引用条款（15 U.S.C.）	来源
cra_dispute	要求消费者报告机构重新调查某条目	1681i(a)(1)(A), (a)(5)(A), (a)(6)(A), (a)(7)	https://www.law.cornell.edu/uscode/text/15/1681i
furnisher_dispute	直接向报告该条目的公司提出争议	1681s-2(a)(8), (a)(8)(D), (a)(8)(E)	https://www.law.cornell.edu/uscode/text/15/1681s-2

联系方式仅在我们于 2026-10-27 核查过该机构的官方网站时才会提供：

机构	信函中的邮寄地址	在线争议	核查日期
Equifax	官方页面未公布：请手动填写	https://www.equifax.com/personal/credit-report-services/credit-dispute/	2026-10-27
Experian	Experian, Dispute by Mail, P.O. Box 4500, Allen, TX 75013	https://www.experian.com/disputes/main.html（需要登录）	2026-10-27
TransUnion	未核实（核查时官方页面返回错误）：请手动填写	未核实：请手动填写	未核查

邮寄信函前，请通过该机构的官方网站核实地址。机构可能会更改地址。

安全

• PrivacyOps 不会发起任何出站网络请求，也不会向任何地方发送数据。
• 删除争议记录前，系统会通过 MCP 客户端的审批提示词征求你的同意。助手无法代你批准。部分客户端无法显示审批提示词。在这些客户端中，除非设置 PRIVACYOPS_DISPUTES_ALLOW_DELETE=true，否则会拒绝删除。
• 每项删除决定（已询问、已批准、已拒绝、已拦截）都会连同争议 ID 追加到审批日志中。日志不会保存姓名、条目文本、原因、备注或信函文本。
• 写入操作绝不会删除其他记录。保存失败时，原文件保持不变；无法读取的文件绝不会被覆盖。
• 免责声明会显示在服务的说明、privacyops_modules、每项技能以及每封信函的页脚中。

检查你的设置

uvx privacyops-mcp --doctor

Doctor 会读取你的数据文件夹、记录文件、信函文件夹和审批日志。它会为每项内容打印 ok 或 FIX，并给出需要采取的步骤；如果有内容需要修复，则以状态码 1 退出。它不会发起网络请求，也不会更改任何文件。

开发

uv venv -p 3.11 && uv pip install -e '.[dev]'
.venv/bin/pytest
python3 scripts/check_skills.py
.venv/bin/python scripts/tool_lock.py --check
.venv/bin/python scripts/security_card.py --check

测试使用临时数据文件夹，不会发起网络请求。对工具、提示词或说明进行有意更改后，运行 scripts/tool_lock.py（不带 --check）会重写锁定文件。请在同一项更改中添加一条变更日志。

安全

通过 GitHub 私下报告漏洞（Security 选项卡中的“Report a vulnerability”）。请参阅 SECURITY.md。

许可证

MIT。由 Seaynic Labs 发布。

---

由 Seaynic Labs 构建。 我们围绕企业自身的系统构建此类工具：本地优先，每项更改都由人工审批。查看定制集成。