Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@schedule-manager Create a schedule for team sync tomorrow at 2 PM with priority 1"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
面向 LLM 工具调用的日程管理系统，提供 MCP Server 和 CLI 两种接口。
Python 3.12+
rhosocial-activerecord — ActiveRecord 模式 ORM
rhosocial-activerecord-postgres — PostgreSQL 异步后端（psycopg3）
MCP SDK v2 — FastMCP，提供标准 MCP 工具接口
python-dateutil — RFC 5545 RRULE 解析
Pydantic — 模型校验
Related MCP server: AI Calendar Assistant
git clone https://github.com/vistart/schedule-manager.git
cd schedule-manager
python -m venv .venv
source .venv/bin/activate
pip install -e .复制 .env.example 为 .env，填入数据库连接信息：
cp .env.example .env.env 示例：
SCHEDULE_DB_HOST=192.168.1.3
SCHEDULE_DB_PORT=17689
SCHEDULE_DB_NAME=schedule_manager_db
SCHEDULE_DB_USER=root
SCHEDULE_DB_PASSWORD=your_password初始化数据库表：
schedule-manager-setup-dbschedules 表结构：
字段 | 类型 | 说明 |
| INTEGER (PK) | 自增主键 |
| TEXT | 日程标题（必填，非空） |
| TEXT | 详细描述 |
| TEXT | 状态： |
| INTEGER | 优先级 1（最高）~ 5（最低），默认 3 |
| TIMESTAMP | 开始时间 |
| TIMESTAMP | 截止时间 |
| TIMESTAMP | 完成时间 |
| TEXT | 地点 |
| JSONB | 标签列表 |
| TEXT | RFC 5545 循环规则 |
| JSONB | 循环例外日期 |
| JSONB | 排除日期 |
| TIMESTAMP | 创建时间（自动） |
| TIMESTAMP | 更新时间（自动） |
| TIMESTAMP | 软删除时间（NULL = 未删除） |
默认 JSON 信封格式：
{"status": "ok", "data": {...}}
{"status": "error", "error": {"code": "NOT_FOUND", "message": "..."}}加 --human 输出人类可读文本。
选项 | 说明 |
| 输出人类可读文本 |
| 输出机器可读的 JSON Schema 并退出 |
| 显示帮助 |
create — 创建日程schedule-manager create --title '团队站会' --priority 3
schedule-manager create --title '部署 v2' --due-time '2026-09-10T14:00:00' --tags 'deploy,critical'
schedule-manager create --title '每日晨会' --rrule 'FREQ=DAILY' --start-time '2026-09-06T09:00:00'参数 | 类型 | 必填 | 说明 |
| string | 是 | 标题（非空） |
| string | 否 | 描述 |
| string | 否 | 状态（默认 pending） |
| int | 否 | 优先级 1-5（默认 3） |
| string | 否 | ISO 8601 开始时间 |
| string | 否 | ISO 8601 截止时间 |
| string | 否 | 地点 |
| string | 否 | 逗号分隔的标签 |
| string | 否 | RFC 5545 循环规则 |
| flag | 否 | 预览，不真正创建 |
get — 查询日程schedule-manager get --id 1update — 更新日程（只修改提供的字段）schedule-manager update --id 1 --status completed
schedule-manager update --id 1 --title '新标题' --priority 1delete — 软删除日程schedule-manager delete --id 1complete — 标记完成schedule-manager complete --id 1list — 分页列表schedule-manager list
schedule-manager list --status pending --sort-by priority --sort-order asc
schedule-manager list --page 2 --page-size 10
schedule-manager list --keyword 会议参数 | 默认值 | 说明 |
| 1 | 页码 |
| 20 | 每页条数（1-100） |
| - | 按状态筛选 |
| - | 按优先级筛选 |
| - | 关键词搜索（匹配标题和描述） |
| due_time | 排序字段：due_time / created_at / updated_at / priority / title |
| asc | 排序方向：asc / desc |
search — 关键词搜索schedule-manager search --keyword deadline退出码 | 含义 |
0 | 成功 |
1 | 一般错误 |
2 | 参数错误 |
20 | 资源不存在 |
40 | 校验错误 |
通过 mcp CLI 启动：
mcp run schedule_manager.mcp_server或在 MCP 客户端配置中添加：
{
"mcpServers": {
"schedule-manager": {
"command": "schedule-manager-mcp",
"args": []
}
}
}工具 | 说明 |
| 创建日程 |
| 按 ID 查询 |
| 更新日程（只改传入的字段） |
| 软删除 |
| 分页列表（支持筛选、排序） |
| 标记完成 |
| 关键词搜索 |
所有工具参数均为命名参数，返回 JSON 字典。
pip install -e ".[test,dev]"pytest tests/ -v需要 PostgreSQL 数据库。测试前确保 .env 配置正确并已执行 schedule-manager-setup-db。
src/schedule_manager/
├── __init__.py
├── config.py # 数据库配置（从 .env 加载）
├── model.py # Schedule ActiveRecord 模型
├── mcp_server.py # FastMCP Server，7 个工具
├── cli.py # CLI 入口，LLM 优化设计
└── setup_db.py # 数据库表初始化脚本MIT
This server cannot be deployed
AI-native scheduling: check availability, book meetings, cancel and reschedule via MCP
Official Akiflow MCP for tasks, calendars, scheduling, time slots, and meeting transcripts.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Create, schedule, and publish social posts, manage accounts, and read analytics as MCP tools.
