项目简介
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 驱动的项目规划和管理。
安装步骤
由于该项目尚在开发中,具体的安装文档尚未完善。根据仓库信息,安装步骤可能包括:
- 克隆 GitHub 仓库到本地:'git clone https://github.com/themotionmachine/OmniFocus-MCP.git'
- 进入项目目录:'cd OmniFocus-MCP'
- 安装项目依赖:'npm install' 或 'yarn install' (需要 Node.js 和 npm 或 yarn 环境)
- 启动 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' 文件的实际绝对路径。
基本使用方法
- 确保已安装 OmniFocus 应用程序并已启动。
- 启动 OmniFocus MCP 服务器。在项目根目录下,根据您的安装方式运行 'npm start' 或 'node src/server.ts' 命令。服务器成功启动后,您应该能在终端看到 "MCP Server connected and ready to accept commands from Claude" 或类似的提示信息。
- 在支持 MCP 协议的 LLM 客户端中,配置上述服务器连接信息。将 JSON 配置信息填入 MCP 客户端的服务器配置界面。
- 使用 LLM 客户端向 OmniFocus MCP 服务器发送 MCP 请求。例如,您可以指示 LLM 客户端调用 'dump_database' 工具来获取 OmniFocus 中的任务列表,或者使用 'add_omnifocus_task' 工具创建一个新的任务。
- 根据 LLM 客户端的界面和操作方式,与 OmniFocus MCP 服务器进行交互,利用 LLM 的自然语言理解能力来管理和操作 OmniFocus 中的任务和项目。
请参考 MCP 协议文档和项目仓库中工具的详细定义,以了解更多高级功能和参数配置。
信息
分类
生产力应用