Granoflow MCP 服务器

Granoflow 是一款用于规划、推进和复盘任务的应用。它可以帮助你从完成过的工作中提炼值得记住的经验和知识，把这些内容转化为复习卡片，并在合适的时间用于快速回顾或间隔复习。

这个 MCP 服务器用于把本机 Granoflow App 的 Local HTTP API 暴露给 AI Agent、IDE 和自动化工具。Agent 可以通过它读取和管理任务、项目、里程碑、每日复盘，以及可用于间隔复习的经验卡片。

适用场景

• 在 Cursor、Codex 或其他 MCP 客户端中连接本机 Granoflow。
• 让 AI Agent 查询、创建、更新或完成 Granoflow 任务。
• 让 Agent 在任务结束时辅助整理工作复盘和经验卡片草稿。
• 在本地隐私边界内，把真实工作流和 AI 辅助执行连接起来。

本地优先与隐私边界

Granoflow 的本地功能可以长期免费使用。如果你关注隐私，也可以不订阅会员：未订阅时，你的数据不会离开本机，也不会上传到云端。

这个 MCP 服务器是一个轻量连接层，不重新实现 Granoflow 的业务逻辑，不直接访问数据库，也不负责启动、构建或发布 Granoflow App。它只连接正在运行的 Granoflow App，把结构化请求转发给本地 API，并返回稳定、可预测的 MCP 工具结果。

使用前要求

• Node.js 20 或更高版本。
• 已安装并正在运行的 Granoflow App。
• Granoflow App 已启用 Local HTTP API。

默认本地 API 地址：

http://127.0.0.1:56789

你也可以通过环境变量覆盖默认地址：

export GRANOFLOW_API_BASE_URL="http://127.0.0.1:56789"
export GRANOFLOW_API_TOKEN="..."

安装

npm install -g @granoflow/mcp-server

也可以直接在 MCP 客户端配置中通过 npx 使用：

npx -y @granoflow/mcp-server

MCP 客户端配置示例

{
  "mcpServers": {
    "granoflow": {
      "command": "npx",
      "args": ["-y", "@granoflow/mcp-server"],
      "env": {
        "GRANOFLOW_API_BASE_URL": "http://127.0.0.1:56789"
      }
    }
  }
}

主要工具能力

• 检查 Granoflow 本地 API 和 MCP 连接状态。
• 读取 Granoflow 版本、能力和可用 AI 工具信息。
• 查询、创建、更新、完成和整理任务。
• 查询、创建、更新和删除项目与里程碑。
• 查看每日复盘，并辅助生成复盘内容或经验卡片草稿。
• 在需要时通过通用 API 请求工具访问新版 Local HTTP API 字段。

写入类工具默认偏保守：在真正修改数据前，会优先返回预览或要求明确写入意图。删除类工具还会要求确认当前资源标题，避免误删。

更多信息

• 项目主页：https://github.com/granoflow/granoflow-mcp-server
• Granoflow 官网：https://granoflow.com