claudememkeep

claudememkeep——共享MCP内存服务器

Claude Code和Claude.ai的共享内存层。这两个接口都连接到同一个MCP服务器，实时读写项目上下文、决策和会话历史。

它的作用

• 克劳德代码 通过MCP工具和（可选）生命周期挂钩连接
• Claude.ai 通过连接器连接
• 对同一PostgreSQL数据库进行读/写操作
• 在所有存储的上下文中进行全文搜索
• 通过Claude Code钩子自动捕获会话

架构：服务器vs.钩子

此回购包含 两个独立的部分 部署方式不同：

┌─────────────────────────────────────────────────────────┐
│                    MCP Server (Docker)                   │
│         server/app.py + PostgreSQL database              │
│         Runs once, centrally, serves everyone            │
│                                                         │
│   Claude.ai ──Connector──> /mcp ──> 6 tools ──> DB     │
│   Claude Code ──MCP─────> /mcp ──> 6 tools ──> DB     │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│              Hooks (local per machine)                   │
│         hooks/*.py — run by Claude Code locally          │
│         Each machine running Claude Code needs its own   │
│         copy of these files + configuration              │
│                                                         │
│   SessionStart  → registers session, syncs MEMORY.md    │
│   SessionEnd    → saves structured session summary      │
│   PreCompact    → archives user messages before compact  │
└─────────────────────────────────────────────────────────┘

服务器 (server/, sql/)是Claude Code和Claude.ai之间的共享桥梁。它被打包到Docker镜像中，并通过onramp、普通Docker或您喜欢的任何方式部署一次。Claude.ai（通过连接器）和Claude Code（通过MCP）都连接到它并共享同一个数据库。对服务器代码的更改需要重建容器(make update-service claude-connector).

钩子 (hooks/)是在安装了Claude Code的每台机器上本地运行的客户端脚本。它们自动化了上下文捕获——同步MEMORY.md、保存会话摘要、在压缩之前归档转录本。服务器可以在不同的机器上为多个Claude Code实例提供服务，但每台机器都需要在中配置的钩子的本地副本 ~/.claude/settings.json.

你什么时候需要更新什么？

先决条件

• 事故 使用Traefik的部署框架
• Docker和Docker Compose
• 已安装Claude Code CLI

入口匝道注意事项： 此应用程序是为在onramp框架内运行而构建的，该框架处理Traefik路由、环境脚手架和服务生命周期。Onramp还会为您安装Docker和Compose，所以如果您使用的是Onramp，这些不是单独的先决条件。也就是说，服务器只是一个Docker Compose堆栈——如果你更愿意独立运行它，可以分叉并根据你的设置调整Compose文件。

安装

步骤1：通过Onramp部署

cd /apps/onramp
make enable-service claude-connector
make restart

这将：

• 将服务YAML符号链接到 services-enabled/
• 自动生成安全值 CLAUDE_CONNECTOR_AUTH_TOKEN 和 CLAUDE_CONNECTOR_DB_PASSWORD
• 创建PostgreSQL数据目录
• 构建并启动MCP服务器及其数据库

步骤2：验证部署

curl https://claude-connector.YOUR_DOMAIN/health
# Should return: {"status":"healthy"}

步骤3：设置您的机密文件

令牌是在步骤1中自动生成的。创建一个钩子将获取的secrets文件：

# Get your token
grep CLAUDE_CONNECTOR_AUTH_TOKEN /apps/onramp/services-enabled/claude-connector.env

# Create ~/.claude/.secrets (gitignored, one-time setup per machine)
cat > ~/.claude/.secrets /dev/null; python3 /path/to/claudememkeep/hooks/session-start.py'",
            "timeout": 10
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'source ~/.claude/.secrets 2>/dev/null; python3 /path/to/claudememkeep/hooks/session-end.py'",
            "timeout": 30
          }
        ]
      }
    ],
    "PreCompact": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'source ~/.claude/.secrets 2>/dev/null; python3 /path/to/claudememkeep/hooks/pre-compact.py'",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

替换 /path/to/claudememkeep 与此repo所在的实际路径。从以下位置读取令牌 ~/.claude/.secrets 您在步骤3中创建的文件中没有秘密。

步骤6：连接Claude.ai（可选）

1. 首选 Claude.ai > 设置 > 连接器 > 添加自定义连接器
2. 姓名： claude-connector （或你喜欢的任何东西）
3. 网址： https://claude-connector.YOUR_DOMAIN/mcp
4. 将OAuth客户端ID和密钥留空
5. 根据需要在对话中启用连接器

关于身份验证的注意事项： 服务器当前运行authless，因为Claude.ai的OAuth 自定义MCP服务器的实现已中断 (人类学/克劳德编码#5826). A. HybridAuthProvider 具有完整的OAuth+静态承载令牌支持 server/app.py --取消注释 auth = 当Anthropic修复他们的客户时。 Claude Code继续发送其承载令牌，该令牌被无害地忽略了。

MCP工具

连接后，这些工具可用：

配置

环境变量

所有配置都在 /apps/onramp/services-enabled/claude-connector.env:

钩子环境变量

这些来源于 ~/.claude/.secrets （见步骤3）：

以（权力）否决 MCP_SERVER_URL 在 ~/.claude/.secrets 如果您的域名与默认域名不同。

本地开发

# Start local dev stack (MCP server + PostgreSQL)
docker compose up --build

# Health check
curl http://localhost:8081/health

# Test a tool call
curl -X POST http://localhost:8081/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer dev-token" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_project_summary",
      "arguments": {"project": "default"}
    }
  }'

本地开发堆栈使用 dev-token 作为身份验证令牌，并映射到端口8081。

建筑

看 架构：服务器vs.钩子 在顶部查看完整图片。