Meetup MCP

meetup mcp

](https://hub.docker.com/r/aaronontheweb/meetup-mcp)

以组织者为中心的MCP服务器，用于管理单个Meetup组。通过Docker Compose作为持久HTTP服务运行——启动一次，从任何Claude Code会话连接。

此服务器故意简单：

• 无内置内容模板
• 无原始GraphQL传递
• 每个服务器实例只有一个组作用域
• 发布由显式配置控制的操作

使用LLM生成事件内容。使用此MCP服务器安全执行Meetup操作。

特性

• authorize --OAuth2授权流（仅限首次运行）
• get_group --组元数据和成员计数
• search_events --按状态搜索： upcoming, past, draft
• get_event --按ID列出的完整事件详细信息
• list_venues --该团体的已知场地
• create_event --默认情况下创建为草稿
• edit_event --更新标题、描述、日期时间、持续时间、地点、路线、特色照片
• add_event_speaker --在活动中添加结构化的演讲者详细信息
• update_event_speaker --编辑结构化的演讲者详细信息或演讲者照片
• remove_event_speaker --从事件中删除结构化演讲者详细信息
• attach_event_speaker_photo --将上传的照片附加到活动演讲者个人资料中
• publish_event --后面有门 MEETUP_ALLOW_PUBLISH=true
• create_event_photo_upload --获取直接上传票（照片ID+上传URL）
• attach_event_photo --将上传的照片附加到活动中

安全模型

• 单组锁通过 MEETUP_GROUP_URLNAME
• 基于模式的能力控制(organizer 对比 read_only)
• 所有写入都需要 organizer 模式
• 默认情况下阻止发布(MEETUP_ALLOW_PUBLISH=false)
• 除非明确启用并请求发布，否则创建为草稿的事件

策略违规返回前缀为的错误 POLICY_DENIED.

部署

先决条件

• Docker+Docker组合
• 具有API访问权限的Meetup Pro帐户
• Meetup OAuth消费者（密钥+秘密）

1.创建Meetup OAuth消费者

1. 首选 https://www.meetup.com/api/oauth/create/
2. 集 重定向URI 到 http://127.0.0.1:8787/meetup/oauth/callback
3. 复制您的 消费者密钥 和 消费者秘密

2.配置环境

复制 .env.example 到 .env 并填写您的值：

cp .env.example .env

MEETUP_GROUP_URLNAME=your-group-urlname
MEETUP_MODE=organizer
MEETUP_ALLOW_PUBLISH=false
MEETUP_OAUTH_KEY=your-consumer-key
MEETUP_OAUTH_SECRET=your-consumer-secret

3.构建容器镜像

dotnet publish src/Meetup.McpServer/Meetup.McpServer.csproj /t:PublishContainer

4.启动服务器

docker compose up -d

服务器运行在 http://localhost:5180/mcp 除非明确停止，否则会自动重新启动。

5.配置克劳德代码

包括 .mcp.json 将Claude Code指向正在运行的服务器：

{
  "mcpServers": {
    "meetup": {
      "type": "http",
      "url": "http://localhost:5180/mcp"
    }
  }
}

6.授权（仅限首次运行）

第一次调用API时，服务器将提示您进行授权。打电话给 authorize 工具——它返回一个在浏览器中打开的URL。在您在Meetup网站上授权后，浏览器将重定向到 http://127.0.0.1:8787/meetup/oauth/callback?code=....

重要提示： 如果服务器在远程计算机（VM、云）上运行，则浏览器重定向将落在您的本地计算机上，而不是服务器上。复制完整的回调URL并运行：

curl "http://YOUR_SERVER:8787/meetup/oauth/callback?code=THE_CODE"

令牌被持久化在Docker卷中(meetup-mcp-tokens)并在容器重启后幸存下来。每个令牌生命周期只需要授权一次。

注： 如果您之前运行过此映像，但OAuth令牌存储无法持久，则您的Docker卷可能拥有不正确的所有权。删除并重新创建它： ``bash docker compose down docker volume rm meetup-mcp-tokens docker compose up -d ``

配置参考

\*在以下情况下不需要 MEETUP_USE_FAKE_API=true

图像上传流程

照片上传分为两个步骤：

1. 呼叫 create_event_photo_upload → 回报 { photoId, uploadUrl }
2. PUT 图像字节直接到 uploadUrl
3. 呼叫 attach_event_photo 或 attach_event_speaker_photo 和 eventId + photoId

结构化扬声器支持

Meetup当前的GraphQL API公开了一个单一的结构化 speakerDetails 每个事件的对象，而不是自由形式的扬声器阵列。MCP服务器通过专注的工具公开这一点：

• add_event_speaker
• update_event_speaker
• remove_event_speaker
• attach_event_speaker_photo

get_event 现在返回结构化的说话者详细信息（如果存在）。

本地开发

dotnet build MeetupMcp.slnx
dotnet test MeetupMcp.slnx

针对内存中的假数据运行（不需要Meetup凭据）：

MEETUP_GROUP_URLNAME=nhdnug \
MEETUP_USE_FAKE_API=true \
dotnet run --project src/Meetup.McpServer/Meetup.McpServer.csproj

仓库

• github： https://github.com/Aaronontheweb/meetup-mcp