JinDaGe - patreon-mcp-server MCP Details

article

README

🚀 Patreon MCP 服务器

本项目可让 AI 助手访问你的 Patreon 创作者数据。它是首个经过认证的 Patreon MCP 服务器，可与 Claude Desktop、Cursor、Windsurf、VS Code Copilot 以及任何兼容 MCP 的客户端配合使用。

🚀 快速开始

1. 获取创作者访问令牌

前往 Patreon 开发者门户，复制你的创作者访问令牌。此令牌仅可访问你自己的活动数据。

2. 配置 MCP 客户端

Claude Desktop：添加到 claude_desktop_config.json 中：

{
  "mcpServers": {
    "patreon": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/patreon-mcp-server", "src/patreon_mcp_server/server.py"],
      "env": {
        "PATREON_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Code：添加到项目根目录的 .mcp.json 中：

{
  "mcpServers": {
    "patreon": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/patreon-mcp-server", "src/patreon_mcp_server/server.py"],
      "env": {
        "PATREON_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

3. 开始使用

向你的 AI 助手询问以下问题：

“展示我的 Patreon 活动”
“按终身支持金额，我的顶级赞助者有哪些？”
“每个等级有多少赞助者？”
“哪些赞助者的付款在减少？”
“列出我最近的帖子”

✨ 可用工具

| 工具 | 描述 | 返回值 | |------|-------------|---------| | fetch_identity | 经过认证的个人资料 | User | | fetch_campaigns | 列出所有活动 | Campaign[] | | fetch_campaign | 包含等级明细的活动详情 | CampaignDetail | | fetch_members | 分页的赞助者列表（每页 100 条） | MemberPage | | fetch_posts | 分页的帖子列表（每页 20 条） | PostPage | | fetch_post | 根据 ID 获取单个帖子 | Post |

分页说明：fetch_members 和 fetch_posts 会返回一个 next_cursor 字段。将其作为 cursor 参数传递，以获取下一页数据。

📚 详细文档

数据字段

赞助者（Member）

full_name（全名）、patron_status（赞助者状态）、pledge_cadence（承诺频率）、lifetime_support_cents（终身支持金额（美分））、currently_entitled_amount_cents（当前应得金额（美分））、last_charge_date（上次收费日期）、last_charge_status（上次收费状态）、will_pay_amount_cents（即将支付金额（美分））、is_follower（是否为关注者）、tiers（等级）、user_name（用户名）

活动（Campaign）

creation_name（创建名称）、patron_count（赞助者数量）、pledge_url（承诺链接）、published_at（发布时间）、url（链接）、vanity（别名）、is_monthly（是否为月度活动）、created_at（创建时间）、image_url（图片链接）、summary（摘要）、one_liner（一句话描述）、pay_per_name（每次支付名称）

等级（Tier）

title（标题）、amount_cents（金额（美分））、description（描述）、published（是否发布）、patron_count（赞助者数量）

帖子（Post）

title（标题）、content（内容）、is_paid（是否付费）、is_public（是否公开）、published_at（发布时间）、url（链接）、embed_data（嵌入数据）、embed_url（嵌入链接）

🔧 隐私与数据

本服务器在设计时充分考虑了赞助者的隐私：

无赞助者电子邮件：不会从 API 请求电子邮件地址。
无私人备注：不包含创作者对赞助者的备注。
只读模式：无写入操作，服务器仅读取你的数据。
无数据存储：MCP 服务器本身不会缓存或持久化任何数据。

⚠️ 重要提示

使用此服务器与 AI 助手配合时，赞助者数据（姓名、承诺金额、收费状态）会发送到你的 AI 提供商（如 Anthropic、OpenAI），并可能根据其数据处理政策临时保留。你有责任确保你的使用符合 Patreon 的创作者隐私承诺和适用的数据保护法律。

本项目与 Patreon 无关联，也未得到其认可。

📦 安装指南

前提条件

Python 3.11 及以上版本
uv 包管理器

# 克隆仓库
git clone https://github.com/kyurish/patreon-mcp-server.git
cd patreon-mcp-server

# 安装依赖
uv sync

# 测试运行
PATREON_ACCESS_TOKEN=your_token uv run src/patreon_mcp_server/server.py

🔧 项目结构

src/patreon_mcp_server/
  server.py        # 入口点
  mcp_server.py    # FastMCP 初始化 + 客户端实例
  tools.py         # @mcp.tool() 定义
  models.py        # Pydantic 模型 + JSON:API 解析器
  utils/
    client.py      # PatreonClient (HTTP 层)

🚧 路线图

本服务器目前为只读模式。如果有足够的需求，将添加写入操作（创建帖子、管理等级、向赞助者发送消息） - 提交问题或给仓库加星以表达你的兴趣。

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE。

💖 支持

如果你觉得本项目有用，请考虑在 Patreon 上支持项目开发。

patreon-mcp-server