Ts Mem MCP

它的成员mcp

一个基于TypeScript的模型上下文协议（MCP）服务器，实现了OpenMemory规范。它为AI应用程序提供了一个存储层，其中包含用于存储和检索内存的工具，旨在与任何兼容MCP的客户端（如Claude Desktop）配合使用。

快速开始

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm run start

特性

• 跨对话和会话的持久记忆
• 基于向量嵌入的语义搜索
• 所有内存的本地存储（不向外部服务器发送任何内容）
• 兼容任何MCP客户端（克劳德桌面等）
• 基于用户和会话的内存隔离

可用内存工具

add_memory

存储新的内存条目以供以后检索。

参数：

• content：要存储为内存的文本内容（必需）
• sessionId：会话标识符（可选）
• agentId：代理标识符（可选）
• metadata：要与内存一起存储的其他元数据（可选）

例子：

{
  "content": "My favorite color is blue",
  "sessionId": "session-456",
  "metadata": {
    "category": "preferences",
    "importance": "high"
  }
}

search_memory

根据与查询的语义相似性搜索记忆。

参数：

• query：查找相关记忆的搜索查询文本（必填）
• sessionId：用于过滤内存的会话标识符（可选）
• agentId：用于过滤内存的代理标识符（可选）
• threshold：相似性阈值介于0和1之间（默认值：0.7）（可选）
• limit：要返回的最大结果数（默认值：10）（可选）

例子：

{
  "query": "What is my favorite color?",
  "threshold": 0.6,
  "limit": 5
}

删除记忆

按ID删除特定内存。

参数：

• memoryId：要删除的内存的ID（必需）

例子：

{
  "memoryId": "d8e8fca2-dc0f-4331-819e-bade0fc66666",
}

项目结构

ts-mem-mcp/
├── src/
│   ├── db/              # Database connection and operations
│   ├── models/          # Memory data models
│   ├── tools/           # MCP Tools implementation
│   │   ├── AddMemoryTool.ts
│   │   ├── SearchMemoryTool.ts
│   │   └── DeleteMemoryTool.ts
│   ├── utils/           # Helper utilities 
│   │   ├── embeddings.ts    # Vector embedding functionality
│   │   └── memory-service.ts # Memory service layer
│   └── index.ts         # Server entry point
├── package.json
└── tsconfig.json

与Claude Desktop一起使用

地方发展

将此配置添加到您的Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ts-mem-mcp": {
      "name": "TypeScript Memory MCP",
      "description": "Local memory infrastructure that provides persistent memory across sessions",
      "enabled": true,
      "command": "node",
      "args":["/absolute/path/to/ts-mem-mcp/dist/index.js"]
    }
  }
}

发布后

发布到npm后，用户可以将此配置添加到他们的Claude Desktop配置文件中：

{
  "mcpServers": {
    "ts-mem-mcp": {
      "name": "TypeScript Memory MCP",
      "description": "Local memory infrastructure that provides persistent memory across sessions",
      "enabled": true,
      "command": "npx",
      "args": ["ts-mem-mcp"]
    }
  }
}

建造和测试

1. 对工具进行更改
2. 跑 npm run build 编写
3. 跑 npm run start 启动服务器
4. 配置Claude Desktop以使用您的服务器

数据存储

所有内存都存储在位于以下位置的SQLite数据库中 ~/.ts-mem-mcp/memory.db。没有数据发送到外部服务器。

了解更多

• MCP框架文件
• Claude桌面文档