智能日程管理MCP工具

git clone <repository-url>
cd mcp-general-plan

uv init . -p 3.14
uv add 'mcp[cli]'
uv add fastmcp pydantic python-dateutil croniter jieba spacy pandas numpy

python main.py

python test_basic_functionality.py

smart_create_schedule(
    title="会议标题",
    start_time="2024-12-15T14:00:00",
    end_time="2024-12-15T15:00:00", 
    description="会议描述",
    location_name="会议室A",
    priority="high",  # low/normal/high/urgent/critical
    category="work",  # personal/work/study/meeting/health/entertainment/other
    tags=["重要", "会议"]
)

natural_create_schedule(
    text_input="明天下午2点到4点在会议室A开会讨论项目进度"
)

natural_query_schedules(
    query="明天下午的重要会议",
    context="昨天刚开完项目启动会"
)

contextual_update_schedule(
    schedule_id=1,
    update_text="把会议时间改到后天上午",
    context="考虑到团队成员时间安排"
)

get_schedules(
    start_date="2024-12-01",  # 可选
    end_date="2024-12-31",    # 可选
    category="work",          # 可选
    status="pending",         # 可选 pending/completed/cancelled
    keyword="会议",           # 可选
    limit=50,                # 可选
    sort_by="start_time",     # 可选
    sort_order="asc"          # 可选 asc/desc
)

get_schedule_by_id(schedule_id=1)

update_schedule(
    schedule_id=1,
    title="新标题",           # 可选
    start_time="2024-12-15T15:00:00",  # 可选
    end_time="2024-12-15T16:00:00",    # 可选
    description="新描述",      # 可选
    priority="urgent",         # 可选
    category="meeting",       # 可选
    status="completed"        # 可选
)

delete_schedule(schedule_id=1)

search_schedules(keyword="团队", limit=20)

get_today_schedules()

get_week_schedules()

check_schedule_conflicts(
    start_time="2024-12-15T14:00:00",
    end_time="2024-12-15T15:00:00",
    exclude_id=1  # 可选，排除特定日程
)

habit_insights(
    analysis_period="month",    # week/month/quarter/year
    include_recommendations=True
)

get_habit_comparison(
    period1="本月",
    period2="上月"
)

productivity_analysis(
    period="week",              # week/month/quarter/year
    include_trends=True,        # 包含趋势分析
    include_recommendations=True
)

get_productivity_trends(
    period_type="month",        # week/month
    periods=4                   # 分析周期数
)

get_upcoming_schedules(hours=24)  # 未来24小时内的日程

ai_search_schedules(
    query="重要的工作安排",
    similarity_threshold=0.3,  # 相似度阈值
    include_completed=False,   # 是否包含已完成
    limit=20
)

intelligent_reminder(
    schedule_id=1,
    reminder_type="smart",     # smart/adaptive/fixed/predictive
    custom_times=["30min", "1hour", "1day"]
)

get_reminder_recommendations(schedule_id=1)

voice_schedule_manager(
    voice_input="帮我创建明天下午3点的会议",
    action="create",           # create/update/query/delete
    emotion_detection=True     # 情感识别
)

get_voice_settings()

update_voice_settings(
    language="zh-CN",
    voice_speed=1.0,
    emotion_intensity=0.8
)

test_voice_recognition(test_text="测试语音识别功能")

mcp-general-plan/
├── main.py                     # MCP服务入口，包含所有工具函数
├── src/
│   ├── __init__.py
│   ├── database/               # 数据库层
│   │   ├── models.py          # 数据库模型
│   │   └── operations.py      # 数据库操作
│   ├── services/              # 业务逻辑层
│   │   ├── schedule_service.py # 日程服务
│   │   └── reminder_service.py # 智能提醒服务
│   ├── schemas/               # 数据模式
│   │   ├── schedule.py        # 日程数据模式
│   │   ├── user.py           # 用户数据模式
│   │   └── analytics.py      # 分析数据模式
│   ├── ai/                    # AI智能模块
│   │   ├── nlp_engine.py     # 自然语言处理引擎
│   │   ├── query_engine.py   # 查询引擎
│   │   ├── context_manager.py # 上下文管理器
│   │   └── semantic_search.py # 语义搜索引擎
│   ├── voice/                 # 语音交互模块
│   │   └── voice_manager.py  # 语音管理器
│   ├── analytics/             # 分析模块
│   │   ├── habit_analyzer.py # 习惯分析器
│   │   └── productivity_tracker.py # 效率追踪器
│   ├── integrations/           # 外部集成
│   ├── utils/                 # 工具类
│   │   └── time_parser.py    # 时间解析工具
├── tests/                     # 测试代码
│   ├── test_basic_functionality.py # 基础功能测试
│   └── test_mcp_client.py    # MCP客户端测试
├── docs/                      # 文档
├── DESIGN.md                  # 详细设计文档
└── README.md                  # 项目说明文档

python test_basic_functionality.py

result = smart_create_schedule(
    title="项目评审会议",
    start_time="2024-12-15T14:00:00",
    end_time="2024-12-15T16:00:00",
    description="Q4项目进度评审",
    location_name="会议室A",
    priority="high",
    category="meeting",
    tags=["项目", "评审", "重要"]
)

result = natural_create_schedule(
    text_input="明天下午2点到4点在会议室A开会讨论项目进度"
)

result = natural_query_schedules(
    query="明天下午的重要会议",
    context="昨天刚开完项目启动会"
)

result = ai_search_schedules(
    query="重要的工作安排",
    similarity_threshold=0.3
)

result = voice_schedule_manager(
    voice_input="帮我创建明天下午3点的会议",
    action="create"
)

result = intelligent_reminder(
    schedule_id=1,
    reminder_type="smart",
    custom_times=["30min", "1hour", "1day"]
)

result = habit_insights(
    analysis_period="month",
    include_recommendations=True
)

result = productivity_analysis(
    period="week",
    include_trends=True
)

result = get_week_schedules()
if result["success"]:
    schedules = result["schedules"]
    work_schedules = [s for s in schedules if s["category"] == "work"]
    print(f"本周有 {len(work_schedules)} 个工作日程")

result = check_schedule_conflicts(
    start_time="2024-12-15T15:00:00",
    end_time="2024-12-15T17:00:00"
)

if result["has_conflict"]:
    print("发现时间冲突:")
    for conflict in result["conflicts"]:
        print(f"- {conflict['title']}: {conflict['start_time']} - {conflict['end_time']}")

# 语义搜索批量相关日程
result = ai_search_schedules(query="所有客户会议")

# 习惯对比分析
comparison = get_habit_comparison(period1="本月", period2="上月")

# 效率趋势分析
trends = get_productivity_trends(period_type="month", periods=3)