PinThePiece MCP 服务器

一个稳健的模型上下文协议（MCP）服务器，提供了一个功能丰富的笔记管理系统。该服务器实现了一个注重数据完整性、组织性和易访问性的先进笔记存储解决方案。主要功能包括分层存储、原子操作、版本控制支持、自动备份和全面搜索功能。

功能

笔记存储系统

服务器实现了先进的笔记存储系统，具有：

• 分层存储结构，以提高组织性和扩展性
• 原子文件操作，确保数据完整性
• 版本控制和元数据支持
• 自动备份
• 并发访问处理
• 全面日志记录

存储结构

~/.pinthepiece/
├── notes/
│   ├── data/
│   │   └── YEAR/
│   │       └── MONTH/
│   │           └── note-name.json
│   ├── backups/
│   │   └── note-name.json.TIMESTAMP.bak
│   └── index.json
└── logs/
    └── notes.log

笔记格式

每个笔记存储为一个 JSON 文件，包含：

• 内容：笔记的主要文本内容
• 创建/修改时间戳
• 分类标签
• 可选描述
• 元数据，包括：
  • 格式版本
  • 最后备份时间戳
  • 内容校验和

资源

服务器实现了一个笔记存储系统，具有：

• 自定义 note:// URI 方案，用于访问单个笔记
• 每个笔记资源具有：
  • 名称：唯一标识符
  • 内容：主要文本内容
  • 描述：可选描述
  • 标签：分类标签列表
  • 元数据：版本和完整性信息
  • MIME 类型：text/plain

数据安全功能

• 原子操作：所有文件写入均使用原子操作，防止损坏
• 备份系统：自动备份以供修改前参考
• 版本控制：文件格式版本控制，确保未来兼容性
• 数据验证：校验和验证和完整性检查
• 并发访问：文件锁定，保证线程安全
• 错误恢复：类似事务的操作，带有回滚功能

提示语句

服务器提供了一个单一的提示：

• summarize-notes：创建所有存储笔记的摘要
  • 可选 "style" 参数来控制详细程度（简洁/详细）
  • 根据风格偏好生成包含所有当前笔记内容的提示

工具

服务器实现了一个工具：

• add-note：向服务器添加新的笔记
  • 接受 "name" 和 "content" 作为必需字符串参数
  • 可选 "tags" 和 "description" 参数
  • 更新服务器状态并通知客户端资源更改
  • 执行原子文件操作并创建备份

配置

存储位置

默认情况下，服务器将笔记存储在：

• ~/.pinthepiece/notes/ - 主存储目录
• ~/.pinthepiece/logs/ - 日志文件

日志记录

• 详细记录所有操作的日志
• 日志轮转以管理空间
• 提供文件和控制台日志输出
• 可配置日志级别

快速上手

安装

苹果电脑（MacOS）

在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json%