Clarik Mcp Server

---

🚀 快速开始

npx clarik install

就是这么简单。Clarik 会检测 Claude Desktop 和 Claude Code，配置好两者， 并在后台静默运行。

╔═══════════════════════════════════════╗
║           Welcome to Clarik           ║
║   Clarity and memory for Claude.      ║
╚═══════════════════════════════════════╝

✅ Detected: Claude Desktop
✅ Detected: Claude Code
✅ Checking compatibility...
✅ Done. Clarik is active.

打开 Claude，开始聊天。Clarik 会记住一切。

---

💡 功能介绍

Clarik 是一个 MCP 服务，可在后台静默解决开发者使用 Claude 时遇到的最大问题：

问题	Clarik 如何解决
🧠 Claude 会忘记会话之间的一切	持久记忆 — 事实、决策和注意事项永不丢失
📄 上下文被填满，质量随之下降	智能注入 — 仅加载最相关的记忆
💸 重复上下文会浪费 Token	Token 优化 — 每月节省 47–73 美元的 API 费用
🔄 上下文被填满后进度丢失	检查点 — 保存进度，并从原处继续
🗂️ 一个项目的记忆泄漏到另一个项目	项目隔离 — 每个代码库都有独立的记忆空间
⚠️ Claude 会修改不该修改的文件	代码库保护 — 修改受保护文件前需要你确认
🤔 Claude 会自行假设，而不提问	假设检查器 — 标记未经核实的说法

---

🔧 全部 20 个工具

免费工具（无需许可证）

工具	功能说明
clarik_memory_learn	从对话中提取并存储事实。移除思考块。
clarik_memory_recall	按相关性、时效性和重要性排序，检索相关记忆。
clarik_memory_list	显示当前项目的所有记忆。
clarik_memory_edit	更新指定的记忆事实。
clarik_memory_clear	按类别清除记忆，或清除全部记忆。
clarik_context_trim	在 Token 预算内智能注入记忆。
clarik_checkpoint_save	保存会话状态的结构化快照。
clarik_checkpoint_resume	从检查点恢复，准确接续上次进度。

Pro 工具（终身使用 20 美元）

工具	功能说明
clarik_project_index	文件用途映射 — 让 Claude 理解整个代码库。
clarik_token_monitor	实时跟踪 Token 用量。在上下文使用率达到 70% 时发出警告。
clarik_memory_archive	将过时记忆移至归档，保持活跃记忆运行流畅。
clarik_conflict_resolver	找出并解决相互矛盾的记忆。
clarik_change_scope_guard	修改前确认受保护文件。
clarik_assumption_checker	Claude 自行假设而不提问时发出标记。
clarik_diff_reviewer	提供带说明的结构化差异审查。
clarik_hallucination_detector	对照实际代码核查相关说法。
clarik_decision_timeline	按日期和原因跟踪架构决策。
clarik_prompt_library	保存并重用提示词模板。
clarik_session_search	对过往会话进行全文搜索。
clarik_export_session	将会话数据导出为 JSON 或 Markdown。

---

💰 Token 节省

Clarik 的智能记忆注入意味着 Claude 处理的冗余 Token 更少。

实际数据（Sonnet 4.6，输入 token 价格为 $3/M）

	不使用 Clarik	使用 Clarik
每次会话的输入 token	~800K	~320K
每次会话的费用	~$3.90	~$1.50
每月费用（20 天）	~$78/mo	~$5–31/mo
每月节省	—	$47–73/mo

Clarik Pro costs $20 once.
Saves $47–73/month.
Pays for itself in 8 days.

---

🏷️ 定价

版本	价格	包含内容
免费版	永久免费	8 个核心工具 — 记忆、上下文、检查点
Pro 终身版	$20	全部 20 个工具。一次付费，永久使用。
Pro 月付版	$8/mo	全部 20 个工具。可随时取消。

→ 获取 Clarik Pro

已有密钥？

npx clarik activate YOUR-KEY

---

🛡️ 安全模式

Clarik 提供四种安全模式，适配不同的工作流：

模式	记忆	防护	适用场景
安全（默认）	✅ 开启	✅ 生效	常规开发
严格	✅ 开启	🔒 全部确认	生产代码、敏感代码库
最简	❌ 关闭	❌ 关闭	最大程度保护隐私、快速任务
创意	✅ 开启	🟡 宽松	原型设计、探索

---

🖥️ CLI 命令

npx clarik install          # Install into Claude Desktop + Claude Code
npx clarik activate KEY     # Unlock Pro tools with license key
npx clarik status           # Show plan, tools, savings, grace period
npx clarik upgrade          # Open clarik.dev/pro in browser
npx clarik uninstall        # Clean removal from all configs

---

🔒 隐私与数据

你的数据绝不会离开你的设备。

• 所有记忆都存储在本地的 ~/.clarik/
• 无遥测、无分析服务器、无云端同步
• 除了使用你自己的 API 密钥向 Anthropic API 发送数据外，不会传输任何数据
• 记忆文件归你所有——它们是纯 JSON 文件，可供你读取、编辑或删除
• 许可证验证是唯一的网络请求（每 24 小时向 Gumroad 验证一次）

---

❓ 常见问题

Clarik 会将我的代码发送到其他地方吗？

不会。 所有数据都保存在你的设备上。Clarik 会将记忆存储为本地 JSON 文件。 唯一的网络请求是通过 Gumroad 验证许可证（Pro 用户每天一次）。

它能与 Claude Desktop 和 Claude Code 配合使用吗？

可以。 安装程序会自动检测并配置两者。

上下文填满后会发生什么？

Clarik 可以为当前会话保存一个检查点，其中包含目标、进度、决策和后续步骤。开启新会话后，使用 clarik_checkpoint_resume 即可立即继续。

我可以离线使用吗？

可以。 免费工具始终支持离线使用。上次成功验证许可证后，Pro 工具有 5 天的离线宽限期。

它能在 Windows 上运行吗？

可以。 提供完整的 Windows 支持，并自动使用 cmd /c 包装器以兼容标准输入输出。 也支持 macOS 和 Linux。

它会与其他 MCP 服务冲突吗？

不会。 所有工具都以 clarik_ 为前缀，以避免名称冲突。

我可以查看 Clarik 记住了哪些内容吗？

可以。 使用 clarik_memory_list 查看所有已存储的记忆，或直接浏览 ~/.clarik/projects/ 中的 JSON 文件。

如何删除我的数据？

npx clarik uninstall        # Remove from Claude configs
rm -rf ~/.clarik/           # Delete all stored data

---

🔧 兼容性

平台	状态
macOS	✅ 完全支持
Windows	✅ 完全支持（cmd /c 包装器）
Linux	✅ 完全支持
Claude Desktop	✅ 自动配置
Claude Code	✅ 自动配置

已知问题

• macOS beta 版：在 macOS beta 版本中，MCP 连接可能不稳定。 如果检测到 beta 版本，安装程序会发出警告。
• 传输方式：Clarik 仅使用 stdio 传输。由于已知的 MCP 兼容性问题，不支持 SSE 和 HTTP 传输。

---

🔍 故障排除

Clarik 工具未在 Claude 中显示

1. 确认安装已成功完成：npx clarik status
2. 重启 Claude Desktop / Claude Code
3. 检查 MCP 配置文件是否已正确写入：
   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

“连接丢失”或频繁断开

Clarik 内置了 30 秒心跳 ping，以保持连接。 如果仍然遇到断开问题：

1. 将 Claude Desktop 更新到最新版本
2. 尽可能避免使用 macOS 测试版
3. 检查 ~/.clarik/ 目录权限

许可证激活失败

1. 检查网络连接
2. 验证密钥格式：CLARIK-XXXX-XXXX-XXXX
3. 重试 — Gumroad 的 API 偶尔会短暂中断
4. Pro 工具在上次成功检查后可离线使用 5 天

---

📊 记忆的工作方式

Clarik 会学习的内容

• ✅ 技术栈和框架选择（“我们使用 Next.js 14 和 App Router”）
• ✅ 架构决策（“从 REST 转为 tRPC”）
• ✅ 文件用途（“lib/auth.ts 负责处理 JWT 和会话”）
• ✅ 注意事项和警告（“不要使用 v2 API — 它有问题”）
• ✅ 用户确认的事实

Clarik 绝不会学习的内容

• ❌ 思考块（<thinking>、<antml-thinking>）
• ❌ 思维链轨迹
• ❌ 推测性猜测
• ❌ 用户纠正前的内容

记忆排序

回忆记忆时，Clarik 会为每条事实评分：

score = (relevance × 0.5) + (recency × 0.3) + (importance × 0.2)

只有得分最高的事实会被注入上下文 — 不会一次性注入所有内容。

项目隔离

每个项目都有自己的记忆空间，基于以下内容生成：

git remote URL → workspace root → package.json name

React 项目的记忆绝不会出现在你的 Python 项目中。

---

法律声明

Clarik 是一款由社区独立开发的工具。 它与 Anthropic PBC 没有任何关联， 也未获得其认可。

Claude® 是 Anthropic PBC 的注册商标。 所有对 Claude、Claude Desktop 和 Claude Code 的引用 仅用于识别兼容性。

Token 成本节省为基于典型开发者使用模式的估算值。 实际节省取决于你的工作流、 模型选择和使用量。

Clarik 会将所有数据存储在你的设备本地。 除使用你自己的 API 密钥调用 Anthropic API 外，不会向任何服务发送数据。

按“原样”提供，不附带任何形式的保证。

完整条款：https://clarik.dev/terms

---