forgetting-engine-mcp 0.5.0

遗忘引擎 MCP 客户端 — 将 Claude Desktop 连接到 knownot.cc 长期记忆服务

遗忘引擎 MCP 客户端

将 Claude Desktop 连接到 knownot.cc 遗忘引擎长期记忆服务。

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

安装

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：

{
  "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：

{
  "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（项目）：

{
  "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：

[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：

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：

{
  "$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 登录后在 "API Keys" 页面创建 Key。