tinderbox-mcp

🚀 Tinderbox MCP 服务器

Tinderbox MCP 服务器是一个模型上下文协议（MCP）服务器，它能让像 Claude 这样的 AI 助手与强大的 macOS 知识管理应用程序 Tinderbox 进行交互。借助该服务器，你可以通过自然语言控制 Tinderbox，并将其与助手可访问的其他服务相连接。

🚀 快速开始

先决条件

• Tinderbox
• Node.js 18 或更高版本
• 一个 MCP 兼容的客户端（仅在此处使用 Claude Desktop 进行测试）

安装

1. 克隆此仓库：

git clone https://github.com/phkus/tinderbox-mcp.git
cd tinderbox-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

运行服务器

使用以下命令运行服务器：

npm run start

与 Claude Desktop 一起使用

1. 将以下配置添加到 Claude Desktop 的配置文件中：

{
  "Tinderbox MCP Server": {
    "path": "/path/to/tinderbox-mcp-server"
  }
}

2. 启动服务器后，可以在 Claude Desktop 中选择 Tinderbox MCP 服务器作为目标。

✨ 主要特性

此服务器涵盖了一系列 Tinderbox 操作，具体如下：

• create_note - 创建文档中的新笔记
• link_notes - 在现有笔记之间创建链接，可选指定链接类型
• update_attributes - 更改指定笔记的属性值
• read_note - 获取笔记内容（当前仅返回笔记标题和正文）
• get_siblings - 找到同一层次结构级别的笔记（此工具和其他工具返回笔记路径及其 ChildCount，以让助手了解可以进一步探索的地方）
• get_children - 获取指定父笔记的所有子笔记
• get_links - 查找某条笔记的所有出站链接

所有这些操作都需要模型知道要使用的文档。默认文档名为 Playground，这是开发者自己的测试文档。其他默认值可以在脚本配置中找到，在 /src/index.ts。

⚠️ 注意事项

⚠️ 重要提示

update_attribute 工具可能会覆盖或删除现有数据，请确保定期备份您的文档。

💡 扩展建议

• 将 Tinderbox MCP 服务器与其他知识管理系统集成
• 添加对 DEVONthink 和 Bookends 的支持
• 实现更复杂的查询功能，如搜索和过滤

🙏 致谢

感谢 Josh Rutkowski 的启发性工作。此项目的主要区别在于，applescript - mcp 将完整的脚本内容传递到终端，而这个实现调用单独的脚本文件。

感谢 Mark Bernstein，Tinderbox 的开发者，感谢他开发了这个可脚本化应用程序。

📄 许可证

本项目采用 MIT 许可证。

🤝 贡献

欢迎在此项目中进行贡献或通过在 Tinderbox 论坛上发送反馈（用户名：pkus）提供反馈。