← 返回目录

Mindwtr MCP Server

官方

让AI助手读取并管理你本地的Mindwtr GTD任务。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 2.4k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 可选 API Key
许可证: AGPL-3.0
最近提交: 今天

57FMRS · C

这是Mindwtr开源GTD应用内置的官方MCP服务器(版本1.1.4,AGPL-3.0许可),通过npm包mindwtr-mcp以stdio方式运行,支持本地任务自动化,并提供可选的自建Cloud只读访问能力。

最强项 · 维护活跃度 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

16/20

文档质量

11/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: manifest 声明了 stdio 传输和 npm 包（[email protected]),原则上可通过 npx 启动,但提供的材料中没有具体工具清单、工具参数 schema,也没有针对该 MCP 服务器的测试或 CI 工作流内容可供核验。README 中的 CI 徽章指向仓库整体 CI,并不能证明覆盖了 MCP 初始化/工具列表握手或错误处理路径。按静态评审规则,没有可验证的执行证据(真实 CI + 覆盖关键路径的测试),分数不得超过 12,鉴于缺乏工具行为与声明的比对证据,判定为happy path 可信但边界情况和工具行为均未经证实。
安全与权限 10/20: 凭证通过环境变量传递（MINDWTR_MCP_CLOUD_TOKEN 为可选 Bearer token、MINDWTR_DB_PATH 为可选文件路径),未见硬编码密钥或明文令牌示例,也没有已知漏洞或伪造身份等红线问题。但 manifest 描述服务器对本地数据进行“automation”(暗示可写/可执行操作,而不仅是只读),而云端部分明确是只读。材料中未提供完整工具列表,无法确认是否对删除、批量操作、恢复备份等破坏性动作有确认机制或最小权限限制,数据边界和授权范围披露不完整,因此处于中等风险区间,而非红线级别。
维护活跃度 16/20: 项目有清晰的许可证（AGPL-3.0),明确的版本号迭代（1.1.4),GitHub Actions CI 徽章、贡献指南（CONTRIBUTING.md)、发行说明索引、Discord 社区和赞助渠道,55+ 未关闭 issue 且未被归档,显示出持续维护迹象和明确的项目所有权（dongdongbh)。未见到专门的安全响应策略文件（如 SECURITY.md)的证据,但整体治理与更新路径清晰,应给予较高分数。
文档质量 11/20: README 对整个应用的功能描述详尽,并给出了 MCP 服务器的安装命令（npm install -g mindwtr-mcp / npx -y mindwtr-mcp)以及外部文档站点链接。manifest 中对环境变量有简要描述。但提供的材料中缺少具体工具参数、返回格式、速率限制、费用说明或针对 MCP 服务器本身的故障排查内容,这些多依赖未展示内容的外部文档站点,存在隐藏假设和验证缺口。
安装易用性 12/20: 安装步骤简单明确(npm 全局安装或 npx 直接运行),stdio 传输类型清楚,环境变量均为可选并附有简短说明,门槛较低。但材料中未给出主流客户端（如 Claude Desktop）的具体配置 JSON 示例,也没有可验证的端到端连接测试证据。根据静态评审规则,在缺乏可验证执行证据的情况下,该维度上限为 15 分,故判定为可用但仍需用户自行拼装客户端配置,略显手动。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

已经在使用Mindwtr管理GTD任务、希望借助AI辅助处理任务的用户
熟悉本地stdio型MCP服务器配置的开发者或高级用户
已部署自建Mindwtr Cloud实例、需要只读查询的自托管用户

不适合谁

未安装Mindwtr或没有本地SQLite数据库的用户
需要通过Cloud进行多用户写入协作的团队(Cloud模式仅为只读)
不熟悉npm包安装和环境变量配置的非技术用户

所需权限

对本地Mindwtr SQLite数据库文件(由MINDWTR_DB_PATH指定)的读写访问
配置Cloud模式时对自建Mindwtr Cloud地址的网络访问(只读)
用于访问Cloud API的Bearer令牌凭证

风险与副作用

服务器对本地数据库有写权限,AI发出的错误任务变更可能污染或损坏本地数据
若Bearer令牌以不安全方式存储在环境变量中,可能造成Cloud访问凭证泄露
任务与项目数据会暴露给所连接的AI模型,数据范围未做额外沙箱限制

安装接入

准备工作

运行环境：Node.js

MINDWTR_MCP_CLOUD_TOKEN 可选密钥可选，自托管 Mindwtr Cloud 只读模式的 Bearer 令牌；从你的自托管 Cloud 实例获取。

其他可选配置项（2 个）

MINDWTR_DB_PATH 可选可选，指定本地 Mindwtr SQLite 数据库文件的路径；不设置时使用默认位置。

MINDWTR_MCP_CLOUD_URL 可选可选，自托管 Mindwtr Cloud 的基础 URL，用于只读 Cloud 模式；使用你自建的 Cloud 服务器地址。

确保已安装Node.js和npm。
在支持stdio型MCP服务器的客户端配置中添加命令 npx -y mindwtr-mcp(或先执行 npm install -g mindwtr-mcp 全局安装后使用 mindwtr-mcp 命令)。
如需指定本地数据库位置,设置可选环境变量 MINDWTR_DB_PATH 指向本地Mindwtr SQLite数据库文件路径。
如需连接自建的Mindwtr Cloud只读模式,设置可选环境变量 MINDWTR_MCP_CLOUD_URL(自建Cloud地址)和 MINDWTR_MCP_CLOUD_TOKEN(访问令牌)。
保存配置并重启客户端,确认连接成功。

claude_desktop_config.json

{"mcpServers": {"mindwtr": {"command": "npx", "args": ["-y", "mindwtr-mcp"]}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mindwtr": {
      "command": "npx",
      "args": [
        "-y",
        "mindwtr-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mindwtr -- npx -y mindwtr-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端中配置 {"mcpServers": {"mindwtr": {"command": "npx", "args": ["-y", "mindwtr-mcp"]}}} 并启动会话；Mindwtr 的任务相关工具应出现在客户端工具列表中，请求列出收件箱任务能返回你的本地数据即证明连接成功。

常见排障

任务无法显示时,检查MINDWTR_DB_PATH是否正确指向本地Mindwtr SQLite文件
确认npm/npx可以正常联网安装mindwtr-mcp包
使用Cloud模式时检查MINDWTR_MCP_CLOUD_URL和MINDWTR_MCP_CLOUD_TOKEN是否配置正确,以及自建Cloud实例是否可访问
查看MCP客户端的stdio连接日志,排查启动或握手错误

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把'给妈妈订生日蛋糕'添加到我的 Mindwtr 收件箱。
列出我今天安排的任务和下一步行动。
帮我把'计划生日派对'整理成一个包含小步骤的项目。
搜索所有标记为'等待中'的任务。

使用场景

让AI助手在对话中帮你整理Inbox、添加或处理GTD任务

通过AI查询逾期任务、等待事项,辅助完成每周回顾(Weekly Review)

在自建Mindwtr Cloud环境下,让AI以只读方式查看任务概览

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Mindwtr MCP服务器是Mindwtr开源GTD(时间管理)应用自带的官方组件,通过stdio方式运行的本地npm包(mindwtr-mcp),让AI助手对本地Mindwtr SQLite数据库中的任务和项目进行自动化操作,并可选择性地以只读方式连接自建(self-hosted)的Mindwtr Cloud实例。