lite-task MCP 服务器

关键词

任务管理本地数据库DenoFresh 框架机器人助理

使用说明（Markdown 格式）

  • 项目简介

    • lite-task 是一个本地优先的任务管理应用，附带 Projects/Tasks/Attachments、日历事件、Telegram 机器人等功能。本仓库实现了一个 MCP 服务器端，允许 Claude/Claude Desktop 等 LLM 客户端通过 MCP 协议读取资源、调用工具、获取 Prompt 等，从而在对话中直接操作和查询任务数据。

  • 主要功能点

    • 提供 MCP 服务器的核心能力：暴露工具列表、执行工具请求、返回结构化结果，支持 JSON-RPC 风格的请求/响应。
    • 资源与工具管理：实现了 list_projects、create_project、get_project、update_project、delete_project、list_tasks、create_task、get_task、update_task、delete_task、get_attachment、list_events、create_event、get_event、update_event、delete_event 等工具。
    • 附加能力：直接通过数据库查询（本地 SQLite 或 Turso 云数据库）访问任务数据，支持附件下载、日历事件等。
    • 多传输模式支持：提供 STDIO 的 MCP 服务器、HTTP 端点（/mcp）以及一个基于 Fresh 的路由，以便在不同部署场景下使用。
    • 客户端友好：提供 Mode 1/Mode 2/Mode 3 三种集成模式，便于在本地、Docker、远程服务器以及直接数据库访问之间切换。
    • 自动化与整合：内置工具定义与工具执行逻辑的实现，方便将对话中的意图转化为对数据库的操作。

  • 安装与运行步骤

    • 依赖与环境
      • 需要 Deno 2.x 及以上环境，使用 Fresh 框架，搭配 SQLite（本地）或 Turso（云数据库）。
    • 启动 MCP 服务端
      • 本地开发模式（STDIO/内置）：deno task mcp
        • 该模式在任务管理应用正在运行时，通过 STDIO 启动一个 MCP 服务，客户端通过标准输入输出进行通信。
      • 内置 HTTP 端点模式（推荐 Cursor/现代客户端使用）：应用启动后，HTTP 端点位于 http://localhost:8011/mcp
    • 启动客户端连接（示例，用于将客户端连接到服务器）
      • 模式2（HTTP 客户端，可编译为独立二进制，便于离线运行）
        • MCP 客户端配置示例： { "mcpServers": { "lite-task": { "command": "deno", "args": ["run", "-A", "/absolute/path/to/lite-task/mcp/http-client.ts"], "env": { "LITE_TASK_URL": "http://localhost:8011" // 服务器 REST API 基础 URL } } } }
        • 说明：
          • server name 为 lite-task，与仓库中的 MCP 服务标识一致。
          • command 为 deno，args 指向 mcp/http-client.ts，env 中的 LITE_TASK_URL 指向本地运行的 lite-task REST API 根地址。
      • 模式1（内置 HTTP 端点直接连接）
        • 客户端配置示例（URL 方式）： { "mcpServers": { "lite-task": { "url": "http://localhost:8011/mcp" } } }
        • 说明：该模式无需启动子进程，客户端直接通过 /mcp 端点访问服务器。

  • 基本使用方法

    • 启动服务
      • 在本地运行环境中，启动 lite-task 任务管理应用（deno task dev / deno task start）以提供后端和 MCP 功能。
    • 配置客户端
      • 选择上述模式之一，将 lite-task 的 MCP 服务器信息配置到客户端（Cursor/Claude 等）即可。
    • 交互方式
      • 通过 MCP 客户端发送工具调用请求（如 list_projects、create_task 等），服务器返回 JSON-RPC 风格的结果或文本内容，协助 LLM 进行对话式管理。
    • 注意事项
      • 确保数据库可写权限、端口暴露正确、以及环境变量（如 Turso、Retell、Telegram 等若使用）配置正确。
      • Mode 3 直接数据库访问需要在同机执行，且需要外部工具读取本地数据库文件。

服务器信息

访问项目