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/ - 日志文件目录。

日志记录

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

错误处理

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

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