FocusRelayMCP

概述

FocusRelayMCP 是专为 macOS 上 OmniFocus 设计的模型上下文协议 (MCP) 服务器。它使 AI 助手能够通过自然语言命令查询任务、项目和标签，而不必手动浏览无尽的列表。该服务器提供全面的过滤功能，包括基于时间的查询、项目健康检测、上下文感知和完成日期过滤。它使用 Swift 构建，并提供多种安装方式，包括 Homebrew、手动二进制安装和从源代码构建。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• list_tasks

  Query tasks with various filters including due dates, completion status, tags, and projects

  试试:What should I be doing today?试试:What tasks do I have in my project?试试:Show me my flagged items
• list_projects

  Query projects with status, task counts, and health indicators

  试试:What projects have no next actions?试试:Show me my stalled projects试试:How many projects did I complete this month?
• list_tags

  Query tags with task counts

  试试:What contexts do I have available?试试:Show me tasks I can do on my Mac
• get_task_counts

  Get aggregate counts for tasks with various filter combinations

  试试:How many tasks are in my inbox?试试:How many tasks did I complete today?
• get_project_counts

  Get counts of projects and actions with completion date filtering

  试试:Count projects completed in the last 30 days试试:How many projects did I complete this month?

可对比工具

安装

# 添加 tap（一次）
brew tap deverman/focus-relay

# 安装 MCP 服务器和 OmniFocus 插件
brew install focusrelay

{
  "mcp": {
    "focusrelay": {
      "type": "local",
      "command": ["/opt/homebrew/bin/focusrelay", "serve"],
      "enabled": true
    }
  }
}

osascript -e 'tell application "OmniFocus" to quit' && sleep 2 && open -a "OmniFocus"

FAQ

查询 OmniFocus 时出现超时错误怎么办？

您需要在第一次时批准安全对话框。当您提出查询时，OmniFocus 会显示一个安全提示，询问'允许脚本控制 OmniFocus吗？' - 点击'运行脚本'。如果您没有看到提示，请检查 OmniFocus 是否在其他窗口后面。

如何更新 FocusRelayMCP？

对于 Homebrew 用户，只需运行 `brew upgrade focusrelay`。对于其他安装方式，请下载最新版本。重要提示：升级时，必须重新安装 OmniFocus 插件，将其再次复制到插件目录。

FocusRelayMCP 对比