项目简介

OmniFocus MCP Server 是一个 Model Context Protocol (MCP) 服务器,旨在将 OmniFocus 任务管理应用的功能集成到支持 MCP 协议的 LLM 应用中。通过该服务器,LLM 可以读取 OmniFocus 中的任务和项目信息,并执行创建任务、创建项目等操作,从而实现更智能化的任务管理和工作流程自动化。

主要功能点

  • 列出任务 (dump_database): 获取 OmniFocus 中未完成的任务列表,以便 LLM 理解用户的当前任务状态,并基于任务信息进行智能决策。
  • 添加任务 (add_omnifocus_task): 允许 LLM 在 OmniFocus 中创建新的任务,可以指定任务名称、项目、备注、截止日期、标签等详细信息,方便用户通过自然语言指令快速添加任务。
  • 添加项目 (add_project): 允许 LLM 在 OmniFocus 中创建新的项目,可以设置项目名称、所属文件夹、备注、截止日期、标签、任务顺序等,支持 LLM 驱动的项目规划和管理。

安装步骤

由于该项目尚在开发中,具体的安装文档尚未完善。根据仓库信息,安装步骤可能包括:

  1. 克隆 GitHub 仓库到本地:'git clone https://github.com/themotionmachine/OmniFocus-MCP.git'
  2. 进入项目目录:'cd OmniFocus-MCP'
  3. 安装项目依赖:'npm install' 或 'yarn install' (需要 Node.js 和 npm 或 yarn 环境)
  4. 启动 MCP 服务器:'npm start' 或 'node src/server.ts'

请关注项目仓库的最新文档以获取更详细和准确的安装指南。

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接到 OmniFocus MCP 服务器:

{
  "serverName": "OmniFocus-MCP",
  "command": "node",
  "args": ["path/to/src/server.ts"]
}

配置信息说明:

  • 'serverName': MCP 服务器的名称,例如 "OmniFocus-MCP",用于在 MCP 客户端中识别和管理不同的服务器连接。
  • 'command': 启动 MCP 服务器的命令,通常是执行服务器主程序的命令。对于 Node.js 项目,通常设置为 "node"。
  • 'args': 启动命令的参数列表,用于指定服务器程序及其所需的参数。这里 '["path/to/src/server.ts"]' 需要替换为 'src/server.ts' 文件在您本地文件系统中的绝对路径。例如,如果您的项目目录在 '/Users/yourname/OmniFocus-MCP',则 'path/to/src/server.ts' 应该替换为 '"/Users/yourname/OmniFocus-MCP/src/server.ts"'。

请务必将 'args' 中的路径替换为 'src/server.ts' 文件的实际绝对路径。

基本使用方法

  1. 确保已安装 OmniFocus 应用程序并已启动。
  2. 启动 OmniFocus MCP 服务器。在项目根目录下,根据您的安装方式运行 'npm start' 或 'node src/server.ts' 命令。服务器成功启动后,您应该能在终端看到 "MCP Server connected and ready to accept commands from Claude" 或类似的提示信息。
  3. 在支持 MCP 协议的 LLM 客户端中,配置上述服务器连接信息。将 JSON 配置信息填入 MCP 客户端的服务器配置界面。
  4. 使用 LLM 客户端向 OmniFocus MCP 服务器发送 MCP 请求。例如,您可以指示 LLM 客户端调用 'dump_database' 工具来获取 OmniFocus 中的任务列表,或者使用 'add_omnifocus_task' 工具创建一个新的任务。
  5. 根据 LLM 客户端的界面和操作方式,与 OmniFocus MCP 服务器进行交互,利用 LLM 的自然语言理解能力来管理和操作 OmniFocus 中的任务和项目。

请参考 MCP 协议文档和项目仓库中工具的详细定义,以了解更多高级功能和参数配置。

信息

分类

生产力应用