realevents

RealEvents MCP Server

通过任何兼容 MCP 的 AI 助手，在 RealEvents 上创建和管理活动。

文档和安装片段：https://realevents.co/mcp

安装

{
  "mcpServers": {
    "realevents": {
      "command": "npx",
      "args": ["-y", "realevents-mcp"]
    }
  }
}

在 macOS 上，Claude Desktop 的配置文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json。其他客户端请参阅其 MCP 文档。

Agent 技能

skills/realevents/SKILL.md 指导助手何时以及如何使用这些工具：在正确的时区创建活动、返回管理链接，以及遵循下文的参加人数和嘉宾名单规则。将 skills/realevents 文件夹复制到客户端的技能目录（对于 Claude Code，目录为 ~/.claude/skills/），并与上方的服务配置放在一起。

工具

公开使用，无需令牌：

工具	描述
list_public_events	浏览即将举行的公开活动。可按形式、日期范围或搜索词筛选。
get_event	根据 slug 获取活动的公开详情。slug 更改后仍会沿用旧链接。
register_for_event	为参加者回复出席情况：参加、可能参加或不参加，并可添加同行者和备注。
create_event	创建新的活动页面。返回公开链接和管理链接。

组织者工具，均需要管理令牌：

工具	描述
get_manage_event	完整的活动详情及嘉宾名单。
list_registrations	单独查看嘉宾名单，可选择按已确认／可能参加／已婉拒进行筛选。
get_event_stats	页面浏览量、参加人数、剩余容量、浏览到出席的转化率。
update_event	更改任何活动详情或设置。
duplicate_event	将活动复制为一周后举行的新草稿。
cancel_event	将活动标记为已取消。页面仍会保留在线。
set_cover	使用公开图片 URL 设置封面图片。
list_comments	查看嘉宾对话：问题、回复和回应。
post_comment	以组织者身份在讨论串中发帖。所有已回复出席的嘉宾都可见。

只有在组织者启用评论的活动上，评论功能才可用（通过 update_event 设置 allow_comments: true）。启用前，两个评论工具都会返回明确说明这一点的消息。

封面图片

set_cover 接受的是公开图片 URL，而不是文件。MCP 工具参数是 JSON 文本，因此助手无法将本地图片交给服务端；如果图片在用户的电脑上，使用管理页面上传会更方便（可拖放、预览和裁剪）。图片宽度约为 1200px 或更大时效果最佳；如果图片尺寸较小，set_cover 会提示这一点，而不会悄悄接受缩略图。

时区

除了 start_datetime，create_event 还接受 timezone（IANA 时区名称，例如 Europe/Paris）。**请设置此参数。**开始时间会按该时区解读，而默认时区是 UTC，因此不设置时区就创建时间为 19:00 的活动，页面会显示为 UTC 时间 19:00：对该时区以外的所有人来说，时间都是错的。

优先使用不带末尾 Z 的当地时间：

start_datetime: "2026-06-15T19:00:00"
timezone:       "Europe/Paris"

出席人数按人数计算

活动的出席人数是总人数：已确认的来宾加上他们带来的所有人。一位来宾带着另外三人到场，就会占用四个名额，因此即使活动仍显示有空余名额，这一行人也可能被拒绝参加。出现这种情况时，错误信息会说明剩余名额数，以便用更少的人数重试，而不是将其报告为失败。

只有 confirmed 答复才可添加同行者，且人数受活动自身的 plus_ones_limit 限制（设为 0 即禁用）。如果组织者收集的是姓名，而非人数，则每位登记的来宾都需要提供姓名。get_event 会报告这两项设置。

管理令牌

使用 create_event 创建的活动会返回一个 manage_token。请妥善保存：这是之后管理活动的唯一方式。

如需设置默认令牌，避免每次调用时都传入：

{
  "mcpServers": {
    "realevents": {
      "command": "npx",
      "args": ["-y", "realevents-mcp"],
      "env": {
        "REALEVENTS_MANAGE_TOKEN": "your-token"
      }
    }
  }
}

安全性

使用 npm Provenance 签名，并通过 GitHub Actions 从此代码库构建。每个已发布版本都可追溯到构建它的确切提交和工作流运行记录。

链接

• realevents.co
• 文档
• GitHub 代码库
• MCP Registry 条目

维护者须知：发布检查清单

发布新版本前：

1. 更新 package.json 中的 version
2. 确认 mcpName: "io.github.ykastelnik/realevents" 仍然存在
3. 更新 server.json 中的 version 和 packages[0].version，使其保持一致
4. 标记 vX.Y.Z 并推送：publish.yml 工作流会处理 npm 发布
5. 在本地运行：./mcp-publisher publish，以同步 MCP Registry 条目

许可证

MIT