关键词

Things 3Apple Notes待办事项管理笔记应用macOSAI 集成LLM 上下文

项目简介

TaskNote Bridge 是一个专为 macOS 设计的本地 Swift 应用程序，它实现了一个完整的 Model Context Protocol (MCP) 服务器。其核心功能是将您在 Things 3 待办事项管理应用和 Apple Notes 笔记应用中的数据和操作能力，通过标准化的 MCP 协议暴露给兼容的大语言模型 (LLM) 客户端（如 Claude Desktop, VS Code MCP 扩展等）。这使得您可以通过 AI 助手直接管理您的待办事项和笔记。

主要功能点

  • Things 3 集成： 允许 AI 访问、创建、编辑、搜索 Things 3 中的待办事项、项目、区域和标签。例如，可以询问今天的待办事项，创建新的任务，或搜索特定项目。
  • Apple Notes 集成： 允许 AI 创建、搜索、获取和管理 Apple Notes 中的笔记。例如，可以创建会议纪要笔记，或搜索包含特定内容的笔记。
  • 完整的 MCP 服务器实现： 支持 JSON-RPC 协议，通过 Stdio 和 TCP 等多种传输方式与 MCP 客户端通信，响应数据查询和工具调用请求。
  • 实时监控界面： 提供一个 macOS 图形用户界面 (GUI)，用于监控服务器状态、实时活动日志、客户端连接以及请求/响应详情。
  • 跨客户端兼容性： 设计用于与任何兼容 MCP 协议的 AI 助手或工具无缝协作。

安装步骤

推荐使用预构建的应用版本进行安装：

  1. 访问项目的 最新发布页面 下载最新的 '.dmg' 安装文件。
  2. 打开下载的 '.dmg' 文件。
  3. 将 'TaskNote Bridge.app' 拖拽到您的 macOS 应用程序文件夹中。
  4. 首次启动应用，它会自动启动 MCP 服务器并在 GUI 中显示状态。

（如果您是开发者，也可以选择从源代码构建，需要 Xcode 14+ 和 macOS 13+。）

服务器配置 (供 MCP 客户端使用)

MCP 服务器需要由兼容的 MCP 客户端来连接和使用。您需要在您的 MCP 客户端（如 VS Code 的 MCP 扩展、Claude Desktop、Cursor 等）中配置如何启动或连接到 TaskNote Bridge 服务器。

通常，客户端配置是一个 JSON 对象，包含一个服务器列表。对于 TaskNote Bridge，您可以配置客户端通过 Stdio 或 TCP 方式连接：

  • Stdio 连接配置： 客户端需要指定启动 TaskNote Bridge 服务器的命令。

    • 名称 (name): 给这个服务器连接起一个名字，例如 '"tasknote-bridge"' 或 '"things-notes"'。
    • 命令 (command): 指定用于启动服务器的可执行文件路径。对于通过应用程序启动 Stdio 服务器，路径通常是 '/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh'。
    • 参数 (args): 启动命令所需的额外参数列表，通常留空 '[]'。

  • TCP 连接配置： 如果 TaskNote Bridge 应用正在运行并开启了 TCP 服务器（默认端口 8000），客户端可以直接通过网络连接。

    • 名称 (name): 给连接起一个名字。
    • 命令 (command): 指定一个网络连接工具，如 '"nc"' (netcat)。
    • 参数 (args): 指定连接的主机和端口，例如 '["localhost", "8000"]'。

请参考您的具体 MCP 客户端的文档，将上述信息添加到其 MCP 服务器配置中。配置完成后，通常需要重启客户端应用。

基本使用方法

配置并启动 MCP 客户端后，您可以通过 AI 助手与 TaskNote Bridge 进行交互：

  1. 通过自然语言： 在支持 MCP 的 AI 聊天界面中，直接用自然语言提出关于 Things 3 或 Apple Notes 的请求。例如：
    • “我今天有什么待办事项？” (AI 调用 'get-today' 工具)
    • “创建一个待办事项：明天上午 10 点参加例会。” (AI 调用 'bb7_add-todo' 工具)
    • “搜索一下关于季度评审的笔记。” (AI 调用 'notes-search' 工具)
    • “创建一个新的笔记，标题是‘产品迭代会议纪要’，内容是...” (AI 调用 'notes-create' 工具)
  2. 通过客户端工具调用界面： 一些客户端（如 VS Code 的 MCP 扩展）提供直接调用 MCP 工具的界面。您可以在工具列表中找到 TaskNote Bridge 提供的工具（如 'bb7_add-todo', 'notes-create' 等），然后输入相应的参数来执行操作。

通过 TaskNote Bridge 应用的 GUI，您可以实时查看 AI 客户端发出的请求以及服务器的处理情况，方便调试和监控。

信息

分类

生产力应用

访问项目