# 安装 Heartwood Memory

- 类型: MCP 工具
- 说明: Governed agent recall with signed provenance and policy gates. BUSL-1.1; not OSI open source.
- 仓库: https://github.com/jermayne36/heartwood-memory

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "Heartwood Memory" MCP 服务：
执行：claude mcp add 'io-github-jermayne36-heartwood-memory' -- uvx heartwood-memory
```

### Codex
```
请帮我安装 askskill 上的 "Heartwood Memory" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-jermayne36-heartwood-memory]
command = "uvx"
args = ["heartwood-memory"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Heartwood Memory" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-jermayne36-heartwood-memory": { "command": "uvx", "args": ["heartwood-memory"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env HEARTWOOD_DB_PATH=YOUR_VALUE --env HEARTWOOD_TENANT=YOUR_VALUE --env HEARTWOOD_MCP_ALLOWED_TOOLS=YOUR_VALUE --transport stdio io-github-jermayne36-heartwood-memory -- uvx heartwood-memory
```
需要环境变量：HEARTWOOD_DB_PATH, HEARTWOOD_TENANT, HEARTWOOD_MCP_ALLOWED_TOOLS

### Codex
```bash
codex mcp add --env HEARTWOOD_DB_PATH=YOUR_VALUE --env HEARTWOOD_TENANT=YOUR_VALUE --env HEARTWOOD_MCP_ALLOWED_TOOLS=YOUR_VALUE io-github-jermayne36-heartwood-memory -- uvx heartwood-memory
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-jermayne36-heartwood-memory]
command = "uvx"
args = ["heartwood-memory"]

[mcp_servers.io-github-jermayne36-heartwood-memory.env]
HEARTWOOD_DB_PATH = "YOUR_VALUE"
HEARTWOOD_TENANT = "YOUR_VALUE"
HEARTWOOD_MCP_ALLOWED_TOOLS = "YOUR_VALUE"
```
需要环境变量：HEARTWOOD_DB_PATH, HEARTWOOD_TENANT, HEARTWOOD_MCP_ALLOWED_TOOLS

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-jermayne36-heartwood-memory": {
      "command": "uvx",
      "args": [
        "heartwood-memory"
      ],
      "env": {
        "HEARTWOOD_DB_PATH": "YOUR_VALUE",
        "HEARTWOOD_TENANT": "YOUR_VALUE",
        "HEARTWOOD_MCP_ALLOWED_TOOLS": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-jermayne36-heartwood-memory&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJoZWFydHdvb2QtbWVtb3J5Il0sImVudiI6eyJIRUFSVFdPT0RfREJfUEFUSCI6IllPVVJfVkFMVUUiLCJIRUFSVFdPT0RfVEVOQU5UIjoiWU9VUl9WQUxVRSIsIkhFQVJUV09PRF9NQ1BfQUxMT1dFRF9UT09MUyI6IllPVVJfVkFMVUUifX0
需要环境变量：HEARTWOOD_DB_PATH, HEARTWOOD_TENANT, HEARTWOOD_MCP_ALLOWED_TOOLS