Metadata-Version: 2.4
Name: forgetting-engine-mcp
Version: 0.5.3
Summary: 遗忘引擎 MCP 客户端 — 将 Claude Desktop 连接到 knownot.cc 长期记忆服务
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: grpcio>=1.80.0
Requires-Dist: protobuf>=4.21

# 遗忘引擎 MCP 客户端

将 Claude Desktop 连接到 [knownot.cc](https://knownot.cc) 遗忘引擎长期记忆服务。

```
Claude Desktop ──stdio──→ MCP Proxy ──gRPC──→ knownot.cc:5005x
```

## 安装

```bash
pip install forgetting-engine-mcp
```

## 获取 Kin ID

安装并配置好 MCP 后，在对话中调用：

```
使用 forgetting_engine_generate_kin 工具
→ 返回 {"kin_id": "84729105361"}
```

复制输出的 kin_id 留存，后续 ingest/retrieve 时作为 kin_id 传入。

## 配置

### Claude Desktop

编辑 `claude_desktop_config.json`：

```json
{
  "mcpServers": {
    "forgetting-engine": {
      "command": "mcp-forgetting-engine",
      "env": {
        "FE_ENDPOINT": "knownot.cc:50051",
        "FE_API_KEY": "fe_ak_your_key_here"
      }
    }
  }
}
```

### Claude Code

编辑 `~/.claude.json`：

```json
{
  "mcpServers": {
    "forgetting-engine": {
      "command": "mcp-forgetting-engine",
      "env": {
        "FE_ENDPOINT": "knownot.cc:50051",
        "FE_API_KEY": "fe_ak_your_key_here"
      }
    }
  }
}
```

## 选择实例

| 实例 | FE_ENDPOINT | 说明 |
|------|-------------|------|
| 通用版 | `knownot.cc:50051` | allergy, preference, constraint, danger |
| 护肤增强版 | `knownot.cc:50052` | 通用 + skincare_* |
| 法律增强版 | `knownot.cc:50053` | 通用 + legal_* |
| 编程增强版 | `knownot.cc:50054` | 通用 + coding_* |

## 环境变量

| 变量 | 必填 | 默认值 | 说明 |
|------|------|--------|------|
| `FE_ENDPOINT` | 否 | `knownot.cc:50051` | 遗忘引擎服务端地址 |
| `FE_API_KEY` | 是 | - | API Key（从 knownot.cc 门户创建） |

## 可用工具

| 工具 | 说明 |
|------|------|
| `forgetting_engine_generate_kin` | 生成新的 11 位 kin_id |
| `forgetting_engine_ingest` | 摄入对话消息到长期记忆 |
| `forgetting_engine_retrieve` | 检索记忆上下文 |
| `forgetting_engine_ingest_features` | 回传/更新用户特征信息 |

## 支持的 MCP 宿主

| 工具 | 配置文件 | 格式 | 状态 |
|------|---------|------|------|
| Claude Code | `~/.claude.json` | JSON | 已验证 |
| Claude Desktop | `claude_desktop_config.json` | JSON | 已验证 |
| Cursor | `~/.cursor/mcp.json` | JSON | 已验证 |
| Codex (OpenAI) | `~/.codex/config.toml` | TOML | 待验证 |
| Hermes | `~/.hermes/config.yaml` | YAML | 待验证 |
| OpenCode | `.opencode.json` | JSON/JSONC | 待验证 |
| OpenClaw | — | — | 不支持 MCP 客户端 |

### Cursor 配置

编辑 `~/.cursor/mcp.json`（全局）或 `.cursor/mcp.json`（项目）：

```json
{
  "mcpServers": {
    "forgetting-engine": {
      "command": "mcp-forgetting-engine",
      "env": {
        "FE_ENDPOINT": "knownot.cc:50051",
        "FE_API_KEY": "fe_ak_your_key_here"
      }
    }
  }
}
```

### Codex 配置

编辑 `~/.codex/config.toml`：

```toml
[mcp_servers.forgetting-engine]
type = "stdio"
command = "mcp-forgetting-engine"
args = []

[mcp_servers.forgetting-engine.env]
FE_ENDPOINT = "knownot.cc:50051"
FE_API_KEY = "fe_ak_your_key_here"
```

### Hermes 配置

编辑 `~/.hermes/config.yaml`：

```yaml
mcp_servers:
  forgetting-engine:
    command: mcp-forgetting-engine
    env:
      FE_ENDPOINT: knownot.cc:50051
      FE_API_KEY: fe_ak_your_key_here
```

### OpenCode 配置

编辑项目根目录的 `.opencode.json` 或 `~/.opencode.json`：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "forgetting-engine": {
      "type": "local",
      "command": ["mcp-forgetting-engine"],
      "enabled": true,
      "environment": {
        "FE_ENDPOINT": "knownot.cc:50051",
        "FE_API_KEY": "fe_ak_your_key_here"
      }
    }
  }
}
```

## 获取 API Key

访问 [knownot.cc](https://knownot.cc) 登录后在 "API Keys" 页面创建 Key。
