项目简介

GSD Task Manager (Get Stuff Done) 是一款注重隐私的个人任务管理应用，它基于艾森豪威尔矩阵帮助用户高效管理任务。此仓库包含GSD Task Manager应用本身，以及一个可选的MCP服务器模块。该MCP服务器模块允许用户将本地存储的加密任务数据，通过标准化的协议提供给支持MCP的AI助手（如Claude Desktop或ChatGPT），实现通过自然语言对任务进行查询、分析和管理。所有敏感操作均在用户本地机器上进行，并采用端到端加密，确保用户数据的隐私和安全。

主要功能点

LLM 任务访问： 允许AI助手读取用户任务的标题、描述、标签、子任务等详细内容。
自然语言查询： 用户可以通过自然语言向AI助手提问，例如“本周我的紧急任务有哪些？”、“显示所有#工作标签的任务”，AI助手将智能地从任务数据中提取信息。
智能搜索与筛选： AI助手能够根据任务的象限、完成状态或自定义标签进行高级搜索和筛选，帮助用户快速定位所需信息。
隐私优先与只读： 任务数据的解密过程完全在用户本地机器上完成，原始数据绝不上传至云端服务器。AI助手对任务数据只有只读权限，不能修改、创建或删除任务，从而最大程度保障用户数据安全。
上下文工具： MCP服务器为AI助手提供了一系列可调用的工具，包括：
- 'list_tasks'：列出所有解密后的任务，支持按象限、状态、标签筛选。
- 'get_task'：根据任务ID获取特定任务的详细信息。
- 'search_tasks'：在任务标题、描述、标签和子任务中进行关键词搜索。
- 'get_sync_status'：检查任务同步状态（如上次同步时间、冲突情况）。
- 'list_devices'：查看所有已注册并同步的设备信息。
- 'get_task_stats'：获取任务统计数据和元数据。

安装步骤

克隆仓库： 首先，将GSD Task Manager的GitHub仓库克隆到您的本地机器。打开终端或命令行工具，运行以下命令：

git clone https://github.com/vscarpenter/gsd-task-manager.git
cd gsd-task-manager

安装依赖： 切换到项目根目录后，安装所有项目依赖。该项目使用 'pnpm' 进行包管理，请确保您的系统中已安装 'pnpm'。
```
pnpm install
```
构建应用（可选，但推荐）： 为了确保所有组件（包括MCP服务器）正确构建和打包，执行构建命令：
```
pnpm build
```
启动 MCP 服务器： MCP服务器作为一个独立的进程运行。根据仓库的README，MCP服务器的代码位于 'packages/mcp-server/' 子目录中。您需要进入该目录并按照其具体的README指示启动服务器。
- 进入MCP服务器目录：
```
cd packages/mcp-server
```
- 启动MCP服务器：通常，您会找到一个启动脚本或命令。例如，可能是：
```
pnpm start 
# 或者可能是 node dist/index.js，具体请查阅 packages/mcp-server/README.md
```
请注意： 具体启动命令和参数需要查阅 'packages/mcp-server/README.md' 文件。MCP服务器启动后，将通过JSON-RPC协议监听LLM客户端的请求。

服务器配置（LLM 客户端使用）

LLM客户端（如Claude Desktop或任何兼容MCP的客户端）需要配置以下信息以连接GSD Task Manager MCP服务器。您通常需要在客户端的设置界面中提供这些配置项。

{
    "server_name": "GSD Task Manager",
    "description": "通过MCP协议连接GSD任务管理器，实现任务的自然语言查询与分析，支持端到端加密。",
    "command": "node /path/to/your/gsd-task-manager/packages/mcp-server/dist/index.js",
    "args": [
        "--port", "8080",
        "--profile", "default",
        "--encryption-passphrase-env", "GSD_ENCRYPTION_PASSPHRASE"
    ],
    "security": {
        "encryption_required": true,
        "passphrase_prompt": "请提供您的GSD加密密码以访问任务数据。"
    }
}

'server_name'：在LLM客户端中显示的MCP服务器名称，建议设置为“GSD Task Manager”。
'description'：对MCP服务器功能的简要说明。
'command'：启动MCP服务器的可执行文件路径。您需要将 '/path/to/your/gsd-task-manager/' 替换为实际克隆仓库的绝对路径，例如 '/Users/yourusername/projects/gsd-task-manager/packages/mcp-server/dist/index.js'。
'args'：启动MCP服务器时传递的参数列表。
- '--port <port_number>'：MCP服务器监听的端口号。请确保该端口未被其他应用占用。常见端口如 '8080'、'8443'。
- '--profile <profile_name>'：指定GSD任务管理器数据配置文件（如果MCP服务器支持多用户或多数据源）。通常设为'default'。
- '--encryption-passphrase-env <ENV_VAR_NAME>'：指示MCP服务器从指定的环境变量中获取加密密码。例如，这里设置为 'GSD_ENCRYPTION_PASSPHRASE'，LLM客户端需要设置这个环境变量。
'security'：安全配置。
- 'encryption_required'：设置为 'true' 表示连接此MCP服务器需要提供加密密码。
- 'passphrase_prompt'：在LLM客户端中提示用户输入加密密码的文本。

重要提示： 上述 'command' 和 'args' 的具体路径和参数可能因 'gsd-mcp-server' 模块的实际实现和您的操作系统环境而异。请务必查阅 'packages/mcp-server/README.md' 文件以获取最准确的命令和参数。LLM客户端通常会提供一个界面来设置这些参数。

基本使用方法

启动 GSD Task Manager 应用： 在您的浏览器中打开已部署或本地运行的GSD Task Manager应用（例如 'https://gsd.vinny.dev' 或本地 'http://localhost:3000'）。确保您的任务数据已加载。
配置云同步和加密（如果适用）： 如果您的任务数据是通过GSD Task Manager的云同步功能存储并加密的，请确保您已在GSD应用中登录并设置了加密密码。MCP服务器将使用相同的机制在本地解密数据。
启动 MCP 服务器： 按照上述“安装步骤”中的说明，在您的本地机器上启动GSD Task Manager的MCP服务器进程。
配置 LLM 客户端： 在您的LLM客户端（如Claude Desktop）中，添加一个新的MCP服务器连接，并使用“服务器配置”部分中生成的信息进行配置。如果需要，输入您的GSD加密密码。
与 AI 助手交互： 配置并连接成功后，您就可以在LLM客户端中直接向AI助手提问关于您的GSD任务的问题了。例如：
- “我的紧急且重要的任务有哪些？”
- “查找所有与‘营销计划’相关的任务。”
- “这个月我完成了多少任务？” AI助手将通过MCP服务器调用相应的工具来获取并分析您的任务数据，然后以自然语言形式给出回答。

关键词

项目简介

主要功能点

安装步骤

服务器配置（LLM 客户端使用）

基本使用方法

信息