Tinderbox Mcp

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
  1. 安装依赖项:
npm install
  1. 构建项目:
npm run build

运行服务器

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

npm run start

与 Claude Desktop 一起使用

  1. 将以下配置添加到 Claude Desktop 的配置文件中:
{
"Tinderbox MCP Server": {
"path": "/path/to/tinderbox-mcp-server"
}
}
  1. 启动服务器后,可以在 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)提供反馈。

  • 0 关注
  • 0 收藏,18 浏览
  • system 提出于 2025-09-28 23:57

相似服务问题