使用说明
项目简介
Pieces LTM MCP 服务器是一个基于 Model Context Protocol (MCP) 的应用后端,它使用 Pieces Long-Term Memory (LTM) 作为知识库,为 LLM 客户端提供本地知识问答能力。该服务器注册了一个名为 "PiecesLTM" 的工具,允许 LLM 通过提问来检索和利用过去 7 天存储在 Pieces LTM 中的信息。
主要功能点
- MCP 服务器实现: 遵循 MCP 协议,作为 LLM 客户端的上下文服务提供者。
- Pieces LTM 集成: 利用 Pieces 长期记忆功能,提供基于本地知识库的问答能力。
- 问答工具: 注册 "PiecesLTM" 工具,允许 LLM 查询 Pieces LTM 中的信息。
- 可配置时间范围: 默认配置为 7 天记忆范围,代码可扩展以支持自定义配置(但当前版本为硬编码)。
安装步骤
- 安装 .NET 9 SDK: 确保您的开发环境已安装 .NET 9 SDK。
- 安装 Pieces 应用并启用 LTM 引擎: 下载并安装 Pieces 桌面应用,并确保已启用 Long-Term Memory (LTM) 引擎。
- 构建项目: 使用以下命令构建项目,将 '<platform>' 替换为您的操作系统平台 RID(例如 'win-x64', 'linux-x64', 'osx-x64'):
构建成功后,可执行文件 'PiecesMCPNet' 将位于 'Release/net9.0/<platform>/publish/' 目录下。dotnet publish -r <platform>
服务器配置
要将 Pieces LTM MCP 服务器注册到 MCP 客户端(例如 Claude for Desktop),您需要在客户端的配置文件中添加服务器信息。以 Claude for Desktop 为例,编辑 'claude_desktop_config.json' 文件,在 'mcpServers' 节点下添加如下配置:
{ "mcpServers": { "PiecesLTM": { "command": "<PiecesMCPNet 可执行文件路径>" } } }
- 'PiecesLTM': 服务器名称,可以自定义,用于在客户端中标识该服务器。
- 'command': PiecesMCPNet 服务器可执行文件的完整路径。请将 '<PiecesMCPNet 可执行文件路径>' 替换为实际的文件路径,例如:
- Windows: 'C:\path\to\PiecesMCPNet.exe'
- Linux/macOS: '/path/to/PiecesMCPNet'
配置完成后,重启 MCP 客户端,服务器将自动注册并可供使用。
基本使用方法
在 MCP 客户端中,您可以使用以下格式的指令来调用 PiecesLTM 工具进行提问:
Ask Pieces LTM <你的问题>
例如,在 Claude for Desktop 中,您可以输入:
Ask Pieces LTM 今天我做了什么有趣的事情?
客户端会将问题发送到 Pieces LTM MCP 服务器,服务器会利用 Pieces LTM 检索相关信息并返回答案。您可能需要在客户端中允许 Pieces 访问聊天或单条消息,以便工具正常工作。
信息
分类
AI与计算