内容
# partiful-mcp
一个MCP服务器，为AI代理提供访问 [Partiful](https://partiful.com) API的功能。查看您的活动、RSVP、主办活动、相互连接和用户资料 — 所有这些都可以通过您的AI助手完成。
> **注意：** 这是一个非官方的、社区建设的工具。它与Partiful无关，也未得到Partiful的认可。
## 快速开始
将以下内容添加到您的MCP客户端配置（Claude Code、Cursor、Windsurf等）：
```json
{
"mcpServers": {
"partiful": {
"command": "npx",
"args": ["-y", "partiful-mcp"],
"env": {
"PARTIFUL_REFRESH_TOKEN": "<您的刷新令牌>"
}
}
}
}
```
## 获取刷新令牌
1. 在Chrome中登录 [partiful.com](https://partiful.com)
2. 打开开发者工具（`Cmd+Opt+I` / `Ctrl+Shift+I`）
3. 进入 **应用程序** → **IndexedDB** → **firebaseLocalStorageDb** → **firebaseLocalStorage**
4. 点击条目 — 展开 `value` → `stsTokenManager` → 复制 `refreshToken` 值
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `get_my_events` | 您被邀请或已RSVP的所有活动 |
| `get_hosted_events` | 您主办的活动 |
| `get_my_upcoming_events` | 您的即将到来的活动（首页的“即将到来”视图） |
| `get_my_past_events` | 您的过去活动（首页的“所有过去活动”选项卡） |
| `get_discoverable_events` | 开放邀请活动（首页的“开放邀请”选项卡） |
| `get_saved_events` | 您保存/书签的活动 |
| `get_followed_events` | 您关注的活动 |
| `get_event` | 特定活动的完整详细信息（按ID） |
| `get_guests` | 活动的完整嘉宾列表 |
| `get_event_comments` | 活动的评论/讨论 |
| `get_event_media` | 上传到活动的照片和媒体 |
| `get_event_restrictions` | 活动的限制（年龄、容量等） |
| `get_event_permission` | 当前用户对活动的权限 |
| `get_event_host_messages` | 活动页面上显示的主持人消息 |
| `get_event_ticketing_eligibility` | 活动是否支持购票 |
| `get_pending_cohost_request` | 活动的待处理共同主持人邀请（如果有） |
| `get_host_promo_codes` | 主持活动的促销代码 |
| `get_host_ticket_types` | 主持活动的票务类型/层级 |
| `get_event_discover_status` | 活动是否在探索/发现页面上列出 |
| `get_cohost_requested_events` | 您被邀请共同主持的活动 |
| `get_all_event_restrictions` | 您所有活动的限制 |
| `get_invitable_contacts` | 可以邀请参加活动的联系人（分页） |
| `get_mutuals` | 您的相互连接 |
| `get_users` | 按ID查找用户资料 |
| `get_users_party_stats` | 用户资料的聚会统计数据（参加、主办的活动） |
| `get_contacts` | 您的联系人列表 |
| `get_my_communities` | 您所属的社区 |
| `get_created_cards` | 您创建的数字卡片 |
| `get_discover_event_decorators` | 探索页面活动卡片的装饰器（“朋友正在参加”等徽章） |
| `mark_notifications_read` | 将活动的所有通知标记为已读（写入操作） |
## 配置
### 环境变量（MCP推荐）
| 变量 | 是否必需 | 描述 |
|----------|----------|-------------|
| `PARTIFUL_REFRESH_TOKEN` | 是 | Firebase刷新令牌 |
| `PARTIFUL_FIREBASE_API_KEY` | 否 | 默认使用Partiful的公开密钥 |
| `PARTIFUL_USER_ID` | 否 | Firebase UID — 在与刷新令牌相同的IndexedDB条目中找到（`uid`字段） |
### 配置文件（替代方案）
服务器还会读取 `~/.partiful-config.json`:
```json
{
"refresh_token": "<令牌>",
"firebase_api_key": "<密钥>",
"user_id": "<UID>"
}
```
环境变量优先于配置文件。
## 许可证
MIT
