Slack-Claude Cron MCP Server

使用说明(Markdown 格式)

  • 项目简介

    • 这是一个用于 Claude Code 等 MCP 客户端的后端 MCP 服务器实现。它实现了时序化任务(Cron/Cron-like)管理相关的 MCP 工具,能够通过 MCP 客户端发起请求,从主进程的 REST API 获取 Cron 作业数据并执行相应操作。
  • 主要功能点

    • 提供 MCP 工具:
      • cron_list:查询已注册的 Cron 作业列表
      • cron_add:添加新的 Cron 作业
      • cron_delete:删除 Cron 作业(按编号或全部删除)
      • cron_run:立即执行某个 Cron 作业
      • cron_status:查询 Cron 服务的状态
    • 通过主进程 REST API 与后端 Cron 数据和任务执行结果交互
    • 以 stdio 传输方式与 MCP 客户端通信,遵循 MCP 的请求-响应模型
    • 具备简单的文本化响应,便于 Claude 等 MCP 客户端显示
    • 与现有的后端数据存储(通过 REST API)解耦,便于维护
  • 安装步骤

    • 需要具备 Node.js 运行环境
    • 安装依赖并编译后运行 MCP 服务器的入口脚本;服务器将通过标准输入输出进行 MCP 通信(通过 stdio 传输)
    • 同时需要后端主进程的 REST API(端口默认 http://localhost:4900),用于 Cron 数据交互
  • 服务器配置(用于 MCP 客户端的连接信息) 下面给出一个 JSON 配置示例,描述服务器的名称、启动命令及参数等信息,MCP 客户端在连接时需要使用该信息来启动并与 MCP 服务器建立连接。请按需要替换实际路径和端口等参数。注:以下仅为配置示例,实际使用时请以你的环境为准。

    { "serverName": "slack-cron-mcp", "command": "node", "args": [ "<path-to-your-project>/dist/mcp/server.js" ], "description": "MCP Cron 服务端,用于通过 Claude Code 等 MCP 客户端管理 Cron 作业,数据通过主进程 REST API 获取并执行。", "_comment": "说明:serverName 为 MCP 客户端显示名称,command/args 指定启动 MCP 服务器的命令与参数。MCP 客户端不需要此处的实现细节,仅需知道如何启动服务器。" }

  • 基本使用方法

    • 启动 MCP 服务器后,MCP 客户端需要向服务器发起相应的 JSON-RPC 请求来查询、添加、删除、执行 Cron 作业以及获取状态。
    • 使用时请确保主进程的 REST API 可用(通常为 http://localhost:4900),该 MCP 服务器会通过该 API 与后端数据进行交互并返回结果给 MCP 客户端。
  • 运行与测试要点

    • 确保后端 REST API 已就绪并可访问 /api/cron、/api/cron/status 等端点
    • 确认 MCP 服务器的 stdio 传输通道正常工作,能够接收 MCP 客户端的请求并返回响应
    • 关注日志输出,确保工具方法如 cron_list、cron_add、cron_run 等调用后能够从 REST API 获取正确数据并返回文本内容
  • 注意事项

    • MCP 服务依赖主进程 REST API 的存在与正确行为,请确保主进程已经提供所需的 API 端点
    • 本 MCP 服务偏向文本化响应,适合 Claude 等模型在对话中展示 Cron 状态与操作结果

服务器信息