MD Planner MCP 服务器

关键词

上下文管理资源托管自动化工具本地化AI集成数据缓存

使用说明（Markdown 格式）

项目简介

  • MD Planner 的 MCP 服务器实现，作为后端服务提供对项目资源、可执行工具和提示模板的标准化访问能力，方便将自然语言模型接入到项目管理场景中。

主要功能点

  • MCP 协议实现与传输支持
    • 通过 JSON-RPC 风格与客户端通信，支持包括 STDIO、HTTP 等传输，提供灵活的接入方式。
  • 资源（Resources）托管与数据访问
    • 提供 mdplanner:// 资源 URI 的统一接口，支持读取项目、任务、笔记、目标等内容的 JSON 表示。
  • 工具（Tools）注册与执行
    • 为项目中的各类实体提供大量 MCP 工具，例如 list_tasks、get_task、create_task、update_task、delete_task 等，以及跨领域的分析、计划、财务、CRM 等工具集合。
    • 统一的输入/输出格式，便于 LLM 进行参数传递和结果消费。
  • 提示模板（Prompts）的定义与渲染
    • 将项目数据与上下文整合成可渲染的提示模板，帮助 LLM 更好地理解和接续对话。
  • 会话与能力声明
    • 通过后端进行会话状态、能力声明与权限控制，支持只读模式、令牌保护等安全特性。
  • 多传输协议与可扩展性
    • 附带 HTTP/HTTPS 接入、STDIO 传输，以及未来扩展的传输通道，便于不同部署场景的接入。
  • 与 Claude/其他 LLM 的集成
    • 提供对外部 LLM 客户端的接口，方便实现“上下文可用性”和“外部功能调用”。

安装与运行

  • 依赖与环境
    • 需要 Deno 环境（2.x 版本或兼容版本）。
  • 启动 MCP 服务
    • MCP 服务基于项目目录启动，示例命令形式如下（需在实际部署中按路径替换项目目录）：
      • deno task mcp <project-directory>
    • 可选项（如缓存等）按实际部署需求配置。
  • 运行入口
    • 服务器实现包含 HTTP 端点 /mcp 与 STDIO 端口的支持，并具备必要的路由与中间件。

服务器配置（JSON，供 MCP 客户端了解连接信息用，客户端实际连接不需要此段代码）

  • serverName: mdplanner
  • command: deno
  • args: ["task", "mcp", "<project-directory>"]
    • 说明：serverName 指服务器的唯一名称，用于 MCP 客户端识别；command/args 指定启动服务器的命令及参数，例如若使用 Claude Desktop 这样的外部客户端，需要在客户端配置中指向该启动命令与参数。实际客户端不依赖此 JSON 运行，只作为连接信息的参考。

基本使用方法

  • 启用路径
    • 选择合适的传输模式（HTTP/STDIO），确保后端 MCP 服务可从客户端访问。
  • 常用场景
    • 客户端查询资源（如 mdplanner://tasks）并获取任务数据的 JSON 表示。
    • 客户端调用工具（如 list_tasks、create_task）获得结构化返回，便于自动化工作流接入。
    • 客户端通过返回的内容进行提示渲染或任务执行的后续处理。
  • 与客户端集成要点
    • 客户端需要知道服务器名称（serverName）以及启动命令和参数，以确保能正确启动并连接到 MCP 服务。
    • 如有安全要求，可通过令牌等方式保护 MCP 端点（如 Bearer Token 保护，参见仓库实现中的 mcpToken 配置）。

常见问题

  • 如何扩展新的工具/资源
    • 在服务端 MCP 实现中扩展新的 Tool/Resource 注册逻辑，并确保前端或客户端在调用时传入合法参数。
  • 怎样启用缓存
    • 如需快速查询，可以开启 SQLite 缓存（具体实现请参考代码中的缓存模块与命令参数）。

关键词 上下文管理, 资源托管, 自动化工具, 本地化AI集成, 数据缓存

分类ID 6

服务器信息

访问项目