Plan_mcp_service

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 ツール

• 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

便利なツール

ツール名	機能の説明	パラメーター
search_plans	計画の検索	keyword
get_plan_statistics	統計情報の取得	なし
reschedule_plan	スケジュールの再設定	plan_id, new_time

🤝 貢献

Issue や Pull Request の投稿を歓迎します！

開発の流れ

1. プロジェクトをフォークします
2. 機能ブランチを作成します
3. 変更をコミットします
4. Pull Request を作成します

📄 ライセンス

本プロジェクトは MIT ライセンスを採用しています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• FastMCP - 強力な MCP フレームワーク
• SQLite - 信頼性の高い組み込みデータベース

📞 サポート

質問や提案がある場合は、以下をご利用ください。

• Issue を投稿する
• 詳しい使用ガイドは USAGE.md をご覧ください

---

FastMCP を使用して ❤️ を込めて作成