使用说明
超高生产率MCP
主控程序 连接的服务器 超高生产率 通过外部工具 可流式传输的HTTP，使用应用内 MCP电桥 插件和 插座。输入.
此存储库是 独立社区桥，而不是官方的超级生产力应用程序。维护者 超高生产率mcp 是 不 超级生产力的所有者或核心团队。有关应用程序本身，请参阅 项目网站 上游源头位于 github超级生产力/超级生产力.
特性
- 任务和项目操作（列表、创建、更新、删除、批处理、重新排序、复制等）
- 标签、计数器、UI助手、持久化插件数据、可选操作调度（受限）
- 与超级生产力并驾齐驱；数据仍保留在应用程序中
需求
文档
| 文档 | 描述 |
|---|---|
| docs/HEADLES_VPS_SETUP.md | 完成无头VPS设置 使用Xvfb、systemd和配置文件同步（建议用于生产环境） |
| docs/INSTALL.md | 超级生产力+插件安装（手动，本地机器） |
| docs/MCP_SERVER.md | 构建、运行、端口、套接字。IO配置 |
| docs/SYSTEMD.md | 示例systemd单位（参考；有关完整说明，请参阅HEADLES_VPS_SETUP.md） |
| docs/ARCHITECTURE.md | 数据流和架构图 |
| docs/CLIENTS.md | 游标和通用MCP客户端 |
| docs/OPENCLAW.md | OpenClaw streamable-http 设置 |
| docs/TROUBLESHOOTING.md | 常见问题和解决方案 |
| 贡献.md | 构建、Git、PR笔记 |
| 安全.md | 漏洞报告 |
快速启动
npm ci
npm run build
npm start # listens on 127.0.0.1:3000 by default
# or: PORT=3996 npm start
安装插件（请参阅 docs/INSTALL.md)，确保 plugin-logic.js 指向与服务器相同的端口和主机（插件默认为 http://127.0.0.1:3996；使用 MCP_HOST=0.0.0.0 对于Docker或仅局域网设置，请参阅 docs/MCP_SERVER.md)，然后启动超级生产力。服务器日志显示 Super Productivity plugin connected: 当桥连接时。
用于无头VPS部署⭐
不要跳过 HEADLES_VPS_SETUP.md 导游。 它涵盖了在无头Linux VPS上部署的完整、经过测试的工作流程：
- 安装Xvfb（虚拟显示器）
- 为Xvfb、MCP服务器和超级生产力创建systemd单元
- 同步插件启用状态 从本地计算机（必需，因为无法在无头会话上启用插件）
- 验证设置并排除常见问题
插件ZIP，在带有显示器和无头VPS的机器上启用
你 必须 在计算机上启用插件 具有正常的显示和GUI 首先，因为Super Productivity没有启用插件的CLI选项。
-
在您的本地计算机上：
- 安装插件：zip
mcp-bridge-plugin/和manifest.json在存档根目录(npm run plugin:zip这样做） - 通过安装 设置→ 插件→ 从文件安装
- 启用它 设置→ 插件→ MCP电桥
- 安装插件：zip
-
启用后，插件文件和设置位于超级生产力配置文件下（例如。
~/.config/superProductivity/在Linux上）。 -
同步到VPS：
- 如果你使用 超级生产力自己的同步 （WebDAV/Nextcloud/等），相同的配置文件（包括插件文件夹和启用状态）可以传播到另一台机器。
- 或，在GUI计算机上启用后，将配置树复制到服务器（请参阅 HEADLES_VPS_SETUP.md 步骤3）。
- A. 在Xvfb上运行超级生产力的VPS 然后就可以使用插件了 已存在并启用.
MCP网址
http://localhost:<PORT>/mcp
工具（概述）
任务工具包括 list_tasks, create_task, update_task, duplicate_task, delete_task, complete_task, batch_update_tasks, reorder_tasks，并在应用程序支持的情况下安排相关字段。还有项目、标签、计数器、UI、数据和生产力辅助工具。使用MCP客户端的工具列表检查正在运行的服务器是否具有权威设置。
npm脚本
| 脚本 | 目的 |
|---|---|
npm run build |
将TypeScript编译为 dist/ |
npm start |
运行MCP服务器(node dist/index.js start) |
npm run dev |
监视模式服务器重新加载(tsx watch … start) |
npm run connect |
CLI：连接套接字客户端（请参阅 docs/MCP_SERVER.md) |
npm run cli:projects / cli:tasks / cli:tags |
CLI：转储列表（服务器+插件必须打开） |
npm run cli -- --help |
列出所有CLI子命令 |
npm run docker:build / docker:run |
构建并运行容器映像 |
npm run docker:restart |
compose down + up -d --build +日志（参见 .env.示例 MCP_DOCKER_COMPOSE_DIR) |
npm run plugin:zip |
将运行时插件文件压缩到 mcp-bridge-plugin.zip （用于安装或同步） |
发展
npm run dev
码头工人
图像集 MCP_HOST=0.0.0.0 因此，服务器接受来自容器外部的连接（例如已发布的端口）。
npm run docker:build
npm run docker:run
从合成文件重新部署（可选 MCP_DOCKER_COMPOSE_DIR 在 .env): npm run docker:restart.
可选：标记图像并将其推送到您控制的注册表(docker tag, docker push, docker login).
在克隆之外编写（公共仓库之外的个人路径）：请参阅 docs/MCP_SERVER.md （章节 Docker Compose（可选）).
贡献和安全
看 贡献.md, 安全.md，以及 代码_OF_CONDUCT.md.
命令行界面
之后 npm run build，跑 node dist/index.js start 或 npm startThe package.json bin 字段还允许 npm link 从克隆 super-productivity-mcp 在你的 PATH.
许可证
ISC——参见 许可证该项目基于超级生产力生态系统的想法和代码；在重新分发时尊重上游许可证。
归因
- 超高生产率 （桌面/网络应用程序）： 超级生产力网站 · 超高生产率 （麻省理工学院）。此MCP服务器是一个独立的、由社区维护的项目，不是官方的超级生产力产品或团队。
- 现有技术/灵感： 社区工作 rochadelon/超高效mcp.