MCP 服务器

Tinderbox MCP Server

一个用于与知识管理工具 Tinderbox 交互的 MCP 服务器。

phkus

开发者工具

README

Tinderbox MCP 服务器

一个模型上下文协议 (MCP) 服务器，使像 Claude 这样的 AI 助手能够与 Tinderbox 交互，Tinderbox 是一个强大的 macOS 知识管理应用程序。这允许您使用自然语言控制 Tinderbox，并将其连接到助手可以访问的其他服务。在后台，它使用 Tinderbox 的 AppleScript 集成来创建和更新笔记，并导航文档的层次结构。

包含的 Tinderbox 操作

该服务器包含以下 Tinderbox 操作的工具：

create_note - 在您的文档中创建一个新笔记
link_notes - 在现有笔记之间创建链接，可以选择链接类型
update_attributes - 更改指定笔记的属性值
read_note - 检索笔记的内容（目前仅为笔记的标题和文本）
get_siblings - 查找同一层级的笔记（此工具和以下工具返回笔记的路径及其 ChildCount，以便助手知道可以在哪里进一步探索）
get_children - 获取指定父笔记的所有子笔记
get_links - 查找来自笔记的所有传出链接

所有这些操作都需要模型知道要使用哪个文档。默认文档当前名为 Playground，这是我自己的测试文档。此值和其他默认值可以在 /src/index.ts 中的脚本配置中更改。

前提条件

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

安装

克隆此存储库：

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

安装依赖项：

npm install

构建项目：

npm run build

运行服务器

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

npm run start

与 Claude Desktop 一起使用

将以下配置添加到 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"]
    }
  }
}

填写您的安装路径和 applescripts 目录的路径。默认情况下，脚本位于安装的根文件夹中，但也可以存储在其他位置以便于编辑。

重新启动 Claude for Desktop
要求 Claude 处理您的 Tinderbox 文档，例如：

“在 Tinderbox 文档 ‘Research project’ 中，根据我们对话的要点创建笔记。”
“在 Tinderbox 文档 ‘Research project’ 中，探索笔记 ‘path/to/note’ 的子节点并建议连接。在创建链接之前与我确认。”
“在 Tinderbox 文档 ‘Research project’ 中，创建一个重现我上传的图像的图表。您可以使用 ‘Xpos’ 和 ‘Ypos’ 属性在 Tinderbox 地图上设置笔记的位置。X 从左到右，Y 从上到下。两者都可以有负数，并且地图没有真正的边界，但作为一般指导，您可以假设左上角为 0 和 0，右下角约为 40 和 40。可以通过更改十六进制代码中的 ‘Color’ 属性来为笔记着色。”