MCP Scheduler

基本能力

产品定位

MCP Scheduler 是一个多功能任务自动化系统，专为需要调度和管理各种自动化任务的用户设计。

核心功能

• 多种任务类型支持：包括 shell 命令执行、API 调用、AI 内容生成和桌面通知
• Cron 调度：使用熟悉的 cron 语法进行精确的调度控制
• 一次性或重复执行：可选择任务仅运行一次或按计划重复执行
• 执行历史记录：跟踪成功和失败的任务执行
• 跨平台：支持 Windows、macOS 和 Linux
• 交互式通知：带有声音的桌面提醒任务
• MCP 集成：与 AI 助手和其他 MCP 兼容客户端无缝连接
• 健壮的错误处理：全面的日志记录和错误恢复

适用场景

• 自动化系统维护任务（如数据库备份）
• 定期数据采集（如 API 调用获取天气数据）
• 自动内容生成（如每周报告）
• 个人或团队提醒系统

工具列表

• 任务管理工具：
• list_tasks: 获取所有计划任务
• get_task: 获取特定任务的详细信息
• add_command_task: 添加新的 shell 命令任务
• add_api_task: 添加新的 API 调用任务
• add_ai_task: 添加新的 AI 任务
• add_reminder_task: 添加带有桌面通知的新提醒任务
• update_task: 更新现有任务
• remove_task: 删除任务
• enable_task: 启用禁用的任务
• disable_task: 禁用活动任务

• run_task_now: 立即运行任务

• 执行和监控工具：

• get_task_executions: 获取任务的执行历史
• get_server_info: 获取服务器信息

使用教程

使用依赖

• Python 3.10 或更高版本
• uv（推荐包管理器）

安装 uv（推荐）：

# For Mac/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# For Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

安装教程

1. 克隆仓库：

git clone https://github.com/yourusername/mcp-scheduler.git
cd mcp-scheduler

1. 创建并激活虚拟环境（使用 uv）：

uv venv
source .venv/bin/activate  # On Unix/MacOS
# or
.venv\Scripts\activate     # On Windows

1. 安装依赖：

uv pip install -r requirements.txt

调试方式

运行服务器：

# 使用默认设置（stdio 传输）
python main.py

# 在特定端口上使用服务器传输
python main.py --transport sse --port 8080

# 使用调试模式获取详细日志
python main.py --debug

与 Claude Desktop 或其他 MCP 客户端集成： 1. 确保已安装 Claude Desktop 2. 打开 Claude Desktop 应用配置 3. 添加服务器配置：

{
  "mcpServers": [
    {
      "type": "stdio",
      "name": "MCP Scheduler",
      "command": "python",
      "args": ["/path/to/your/mcp-scheduler/main.py"]
    }
  ]
}

或使用 fastmcp 工具：

fastmcp install main.py --name "Task Scheduler"

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。