Tinderbox MCP Server

Tinderbox MCP Server

site icon
2025.04.06 0
AppleScript知识管理自动化操作开发效率
Tinderbox MCP Server 是一个模型上下文协议(MCP)服务器,旨在使AI助手(如Claude)能够与Tinderbox(一款强大的macOS知识管理应用程序)进行交互。通过自然语言控制Tinderbox,并连接到助手可访问的其他服务。该服务器利用Tinderbox的AppleScript集成功能,创建和更新笔记,并导航文档的层次结构。
View on GitHub

Overview

基本能力

产品定位

Tinderbox MCP Server 是一个桥梁,连接AI助手与Tinderbox知识管理工具,实现自然语言控制和自动化操作。

核心功能

  • 创建笔记:在文档中创建新笔记。
  • 链接笔记:在现有笔记之间创建链接,可选择链接类型。
  • 更新属性:更改指定笔记的属性值。
  • 读取笔记:检索笔记的内容(目前仅限标题和文本)。
  • 获取同级笔记:查找同一层次级别的笔记。
  • 获取子笔记:获取指定父笔记的所有子笔记。
  • 获取链接:查找笔记的所有出站链接。

适用场景

  • 知识管理:自动化创建和组织知识库中的笔记。
  • 研究项目:帮助整理研究资料,自动生成笔记和链接。
  • 内容生成:根据对话或上传的内容自动生成Tinderbox图表。

工具列表

  • create_note:创建新笔记。
  • link_notes:创建笔记间的链接。
  • update_attributes:更新笔记属性。
  • read_note:读取笔记内容。
  • get_siblings:获取同级笔记。
  • get_children:获取子笔记。
  • get_links:获取笔记链接。

常见问题解答

  • 安全性update_attribute工具可能覆盖现有笔记属性,建议备份文档。
  • 扩展性:可通过编辑AppleScript文件或添加新脚本扩展功能。

使用教程

使用依赖

  • 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

调试方式

  1. 配置Claude Desktop的配置文件(~/Library/Application Support/Claude/claude_desktop_config.json):
{
  "mcpServers": {
    "tinderbox-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/tinderbox-mcp/build/index.js", "/absolute/path/to/your/applescripts"]
    }
  }
}
  1. 重启Claude Desktop。
  2. 使用自然语言指令操作Tinderbox文档。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。