mcp-ical MCP 服务器

mcp-ical MCP 服务器

让您的 AI 助手连接日历:mcp-ical 赋能助手用简单自然语言管理事件、查询空闲和自动排程。

“mcp-ical” MCP 服务器有什么作用?

mcp-ical MCP 服务器作为 AI 助手与您的 macOS 日历之间的桥梁,实现了无缝的自然语言日历管理交互。借助 Model Context Protocol (MCP),mcp-ical 让用户可以通过对话查询日程、创建事件、更新约会并管理多个日历。这极大提升了生产力,将本需手动操作的日历事务转变为直观的 AI 自动化流程。凭借智能提醒、重复事件、自定义日历(包括通过 iCloud 集成的 Google 日历)等功能,mcp-ical 简化了日程安排、可用性检查和事件更新,是开发者和希望将日历管理集成到 AI 工作流或个人流程中的用户的得力工具。

提示词列表

仓库文档及代码中未明确列出提示词模板。

资源列表

文档未描述任何明确的 MCP 资源,文件中也未提供。

工具列表

  • 事件创建:根据自然语言输入即时生成日历事件。
  • 智能日程查询:依据用户查询获取即将到来的事件并检查可用时间。
  • 事件更新:修改已有事件,包括时间、日期、日历、地点、备注、提醒和重复。
  • 日历列表:查看全部可用日历并获得智能建议。

典型应用场景

  • 自然语言日历管理: 用户可直接询问 AI 助手诸如“下周我有什么安排?”等问题,获得有序摘要,无需手动翻查日历应用。
  • 自动化事件创建: 开发者可将服务器集成进工作流,实现会议、提醒、截止等事件的自动日程安排。
  • 智能可用性查询: 快速查找会议或约会的空档时间,提升效率,减少沟通往返。
  • 事件修改: 直接通过自然语言请求,轻松更新已有日历事件的细节,如改期、变更地点或添加备注等。
  • 多日历及 Google 日历支持: 统一对话界面管理多个日历,包括通过 iCloud 同步的 Google 日历。

设置方法

Windsurf

  1. 前置要求:确保已安装 Node.js 和 Python 3.12+。
  2. 定位 Windsurf 配置文件(如 windsurf.config.json)。
  3. mcpServers 区块中加入 mcp-ical MCP 服务器:
    {
      "mcpServers": {
        "ical-mcp": {
          "command": "npx",
          "args": ["@mcp-ical/mcp-server@latest"]
        }
      }
    }
    
  4. 保存配置并重启 Windsurf。
  5. 确认 MCP 集成中已出现该服务器。

API 密钥安全:

{
  "mcpServers": {
    "ical-mcp": {
      "command": "npx",
      "args": ["@mcp-ical/mcp-server@latest"],
      "env": {
        "ICAL_API_KEY": "${ICAL_API_KEY}"
      },
      "inputs": {
        "ICAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude

  1. 前置要求:Python 3.12+。
  2. 打开 Claude 集成配置文件。
  3. 插入如下 mcp-ical 配置:
    {
      "mcpServers": {
        "ical-mcp": {
          "command": "npx",
          "args": ["@mcp-ical/mcp-server@latest"]
        }
      }
    }
    
  4. 保存并重启 Claude。
  5. 验证日历连接。

Cursor

  1. 前置要求:确保已安装 Node.js 和 Python 3.12+。
  2. 定位 Cursor 配置文件。
  3. 添加 mcp-ical 服务器:
    {
      "mcpServers": {
        "ical-mcp": {
          "command": "npx",
          "args": ["@mcp-ical/mcp-server@latest"]
        }
      }
    }
    
  4. 保存并重启 Cursor。
  5. 确认服务器以 MCP 模式运行。

Cline

  1. 前置要求:安装 Node.js 和 Python 3.12+。
  2. 编辑 Cline 配置文件。
  3. 添加 mcp-ical 服务器配置:
    {
      "mcpServers": {
        "ical-mcp": {
          "command": "npx",
          "args": ["@mcp-ical/mcp-server@latest"]
        }
      }
    }
    
  4. 保存文件并重启 Cline。
  5. 通过简单日历指令进行测试。

注意: 请将 ICAL_API_KEY 及其他敏感值替换为环境变量以确保凭证安全。

在流程内使用该 MCP

FlowHunt 中使用 MCP

要将 MCP 服务器集成进 FlowHunt 工作流,首先添加 MCP 组件并与您的 AI 助手连接:

FlowHunt MCP flow

点击 MCP 组件打开配置面板。在 system MCP 配置区块,按如下 JSON 格式插入您的 MCP 服务器详情:

{
  "ical-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后,AI 助手即可作为工具使用该 MCP,具备其全部功能。请记得将 “ical-mcp” 替换为实际 MCP 服务器名称,并更换为您自己的 MCP 服务器 URL。


总览

区块可用性详情/备注
总览
提示词列表未指定提示词模板
资源列表未列出明确资源
工具列表文档中有日历工具说明
API 密钥安全提供了示例
采样支持(评测时不重要)未说明

Roots 支持:⛔ 未说明
采样支持:⛔ 未说明


根据表格信息,MCP-ical 服务器在功能及配置上文档完善,但缺少明确的资源和提示词模板,没有提及 Roots 或采样支持。综合实用性及文档完整度,评分为 6/10。

MCP 评分

有 LICENSE✅ (MIT)
有至少一个工具
Fork 数41
Star 数125

常见问题

mcp-ical MCP 服务器有什么作用?

它充当 AI 助手与您的 macOS 日历之间的桥梁,实现用自然语言创建、更新、查询日程和多日历管理,包括通过 iCloud 集成的 Google 日历。

mcp-ical 能管理多个日历或 Google 日历吗?

可以,mcp-ical 支持多日历以及(如通过 iCloud 同步的)Google 日历集成,所有操作都可通过单一对话界面完成。

如何保护我的 API 密钥安全?

请将 API 密钥和敏感凭证作为环境变量存储在 MCP 服务器配置中,避免硬编码敏感信息,并参考提供的环境变量设置示例。

如何将 mcp-ical 添加到我的 FlowHunt 流程?

在流程中添加 MCP 组件,打开其配置,在 System MCP 部分按文档 JSON 格式插入 mcp-ical 服务器详情。根据需要替换服务器 URL 和名称。

mcp-ical 的实际应用场景有哪些?

自动创建日程、查询可用时间、修改约会、获取日历摘要——只需与 AI 助手对话即可。适用于效率提升、开发者工作流和个人日程管理。

试用 FlowHunt 搭配 mcp-ical

将 mcp-ical MCP 服务器集成到您的 FlowHunt 流程中,开启无缝 AI 日历管理。

了解更多

Google 日历 MCP 服务器
Google 日历 MCP 服务器

Google 日历 MCP 服务器

Google 日历 MCP 服务器使 AI 代理能够访问、管理和自动化 Google 日历事件,包括列出、创建、更新和删除事件,处理重复和智能导入,并检查用户可用性——所有操作都通过安全、可扩展的模型上下文协议集成完成。...

2 分钟阅读
AI Calendar +5
Calendly MCP 服务器集成
Calendly MCP 服务器集成

Calendly MCP 服务器集成

Calendly MCP 服务器通过统一的 MCP 接口将 AI 助手与 Calendly 的日程安排工具连接起来,实现自动化事件管理、预约调度以及在 FlowHunt 工作流中无缝集成日历。...

2 分钟阅读
AI MCP +5
iMCP MCP服务器集成
iMCP MCP服务器集成

iMCP MCP服务器集成

iMCP MCP服务器为AI助手与Mac原生应用之间架起桥梁,安全访问信息、联系人、日历、提醒事项、天气、地图等,助您实现无缝AI自动化与注重隐私的集成,提升生产力。...

1 分钟阅读
AI macOS +5