PinThePiece

🚀 PinThePiece MCP 服务器

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

🚀 快速开始

安装

苹果电脑（MacOS）

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

错误处理

服务器实现全面的错误处理：

• 详细错误日志，带堆栈跟踪
• 自动清理临时文件
• 中断操作恢复功能
• 备份还原能力
• 加载/保存时的数据验证

✨ 主要特性

笔记存储系统

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

• 分层存储结构：提高组织性和扩展性。
• 原子文件操作：确保数据完整性。
• 版本控制和元数据支持：便于管理和维护。
• 自动备份：保障数据安全。
• 并发访问处理：允许多用户同时操作。
• 全面日志记录：方便问题排查。

存储结构

~/.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/ - 日志文件

日志记录

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