使用说明

项目简介

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 天记忆范围,代码可扩展以支持自定义配置(但当前版本为硬编码)。

安装步骤

  1. 安装 .NET 9 SDK: 确保您的开发环境已安装 .NET 9 SDK。
  2. 安装 Pieces 应用并启用 LTM 引擎: 下载并安装 Pieces 桌面应用,并确保已启用 Long-Term Memory (LTM) 引擎。
  3. 构建项目: 使用以下命令构建项目,将 '<platform>' 替换为您的操作系统平台 RID(例如 'win-x64', 'linux-x64', 'osx-x64'):
    dotnet publish -r <platform>
    构建成功后,可执行文件 'PiecesMCPNet' 将位于 'Release/net9.0/<platform>/publish/' 目录下。

服务器配置

要将 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与计算