MCP 服务器

PlanManager MCP Server

A hierarchical plan management system built on FastMCP and SQLite that enables users to create, track, and manage various types of plans including travel itineraries, study schedules, and work tasks with templates, search capabilities, and progress statistics.

README

PlanManager MCP Server

🚀 基于FastMCP框架和SQLite的通用计划管理系统

一个功能强大的MCP服务器，支持创建、管理和追踪各类计划，特别适合旅行计划、学习计划、工作任务等多层级项目管理。

✨ 特性

📋 核心功能

🏗️ 层级管理 - 支持父子计划的层级结构
🗄️ 数据持久化 - 基于SQLite的可靠数据存储
🔍 智能搜索 - 按名称和描述搜索计划
📊 统计分析 - 实时查看计划完成情况
🔄 状态管理 - 完整的计划生命周期管理

🎯 快速模板

✈️ 旅行计划模板 - 一键创建完整的旅行计划
📚 学习计划模板 - 自动生成学习进度安排
💼 工作计划模板 - 灵活的任务分解

🛠️ 高级功能

📝 批量创建 - 支持一次性创建多个子计划
🏷️ 分类管理 - 多种类别标签支持
📅 时间管理 - 灵活的开始时间和截止日期
💾 元数据扩展 - JSON格式的自定义数据支持

🚀 快速开始

环境要求

Python 3.14+
UV (推荐) 或 pip

安装

# 克隆项目
git clone <your-repo-url>
cd plan-server-mcp

# 安装依赖
uv sync

# 或者使用pip
pip install -e .

运行

# 启动MCP服务器
uv run main.py

# 或者
python main.py

📖 使用指南

基础操作

创建计划

# 创建通用计划
create_plan(
    name="我的新项目",
    description="这是一个重要的项目",
    category="工作",
    scheduled_at="2025-01-01",
    deadline="2025-03-31"
)

添加子计划

# 添加子步骤
add_step(
    plan_id=1,
    name="需求分析",
    description="完成项目需求文档",
    scheduled_at="2025-01-05"
)

快速模板

🌍 创建旅行计划

create_travel_plan(
    destination="日本",
    start_date="2025-04-01",
    end_date="2025-04-10",
    budget=15000,
    description="东京、大阪、京都文化之旅"
)

📖 创建学习计划

create_study_plan(
    subject="机器学习",
    duration_weeks=8,
    start_date="2025-01-15",
    description="深入学习机器学习算法和实践"
)

查询和管理

查看计划

# 列出所有计划
list_plans()

# 按类别筛选
list_plans(category="旅行")

# 查看详情
get_plan_details(plan_id=1)

更新状态

# 更新计划状态
update_plan_status(plan_id=1, status="in_progress")

搜索和统计

# 搜索计划
search_plans(keyword="学习")

# 获取统计信息
get_plan_statistics()

📊 数据库设计

表结构

CREATE TABLE plans (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,                    -- 计划名称
    description TEXT,                       -- 描述
    category TEXT DEFAULT 'general',       -- 类别
    parent_id INTEGER,                     -- 父计划ID
    scheduled_at DATE,                     -- 开始时间
    deadline DATE,                         -- 截止时间
    status TEXT DEFAULT 'pending',         -- 状态
    metadata TEXT,                         -- 元数据(JSON)
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (parent_id) REFERENCES plans (id) ON DELETE CASCADE
);

状态说明

pending - 待开始
in_progress - 进行中
completed - 已完成
cancelled - 已取消

类别标签

general - 通用
旅行 - 旅行相关
学习 - 学习计划
工作 - 工作任务
健康 - 健康管理
习惯 - 习惯培养

🏗️ 架构设计

PlanManager MCP Server
├── FastMCP Framework      # MCP协议层
├── SQLiteDB              # 数据持久化层
├── Plan Management       # 业务逻辑层
└── Template System       # 模板系统

核心组件

1. SQLiteDB 类

数据库连接管理
CRUD操作封装
事务支持

2. MCP Tools

create_plan - 创建计划
add_step - 添加子步骤
update_plan_status - 更新状态
get_plan_details - 获取详情
list_plans - 列出计划
delete_plan - 删除计划

3. 模板系统

create_travel_plan - 旅行计划模板
create_study_plan - 学习计划模板
create_plan_batch - 批量创建

🔧 开发

项目结构

plan-server-mcp/
├── main.py              # 主程序文件
├── pyproject.toml       # 项目配置
├── uv.lock             # 依赖锁定文件
├── README.md           # 项目文档
└── USAGE.md            # 使用指南

本地开发

# 开发模式运行
python main.py

# 代码检查
python -m py_compile main.py

# 测试数据库
sqlite3 plans.db ".schema"

📝 API 参考

核心工具

工具名	功能描述	参数
`create_plan`	创建计划	name, description, category, scheduled_at, deadline, metadata
`add_step`	添加子步骤	plan_id, name, description, scheduled_at, metadata
`update_plan_status`	更新状态	plan_id, status
`get_plan_details`	获取详情	plan_id
`list_plans`	列出计划	category, status
`delete_plan`	删除计划	plan_id

模板工具

工具名	功能描述	参数
`create_travel_plan`	创建旅行计划	destination, start_date, end_date, budget, description
`create_study_plan`	创建学习计划	subject, duration_weeks, start_date, description
`create_plan_batch`	批量创建	name, children, category, description