PinThePiece MCP server

基本能力

产品定位

PinThePiece MCP server 是一个专注于笔记管理和存储的服务器，提供高效、安全的数据管理解决方案。

核心功能

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

适用场景

• 个人笔记管理
• 团队协作笔记
• 数据完整性要求高的存储场景
• 需要版本控制的文档管理

工具列表

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

常见问题解答

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

使用教程

使用依赖

确保已安装 Claude Desktop 并正确配置。

安装教程

MacOS 配置

~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows 配置

%APPDATA%/Claude/claude_desktop_config.json

开发/未发布服务器配置

"mcpServers": {
  "pinthepiece": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/pmoreira/create-python-server/pinthepiece",
      "run",
      "pinthepiece"
    ]
  }
}

已发布服务器配置

"mcpServers": {
  "pinthepiece": {
    "command": "uvx",
    "args": [
      "pinthepiece"
    ]
  }
}

调试方式

建议使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory /Users/pmoreira/create-python-server/pinthepiece run pinthepiece

启动后，检查器将显示一个可以在浏览器中访问的 URL 以开始调试。

许可证

None