Patreon

Patreon MCP 服务

mcp-name: io.github.KyuRish/patreon-mcp-server

让 AI 助手访问你的 Patreon 创作者数据。首个经过身份验证的 Patreon MCP 服务——可与 Claude Desktop、Cursor、Windsurf、VS Code Copilot 及任何兼容 MCP 的客户端配合使用。

快速开始

1. 获取你的创作者访问令牌

前往 Patreon Developer Portal，复制你的 Creator Access Token。此令牌仅可访问你自己的活动数据。

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 参数传入即可获取下一页。

数据字段

支持者

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

活动

creation_name、patron_count、pledge_url、published_at、url、vanity、is_monthly、created_at、image_url、summary、one_liner、pay_per_name

等级

title、amount_cents、description、published、patron_count

帖子

title、content、is_paid、is_public、published_at、url、embed_data、embed_url

隐私与数据

此服务在设计时充分考虑了支持者隐私：

• 不获取支持者邮箱——不会通过 API 请求电子邮件地址
• 不获取私人备注——不会包含创作者对支持者的备注
• 只读——不执行写入操作，服务仅读取你的数据
• 不存储数据——MCP 服务本身不会缓存或持久化任何数据

重要提示：将此服务与 AI 助手配合使用时，支持者数据（姓名、支持金额、扣款状态）会发送给你的 AI 服务提供商（例如 Anthropic、OpenAI），并可能根据其数据处理政策暂时保留。你有责任确保自己的使用符合 Patreon 的创作者隐私承诺及适用的数据保护法律。

本项目与 Patreon 无关联，也未获得 Patreon 的认可。

前置条件

• Python 3.11+
• uv 包管理器

# Clone the repo
git clone https://github.com/kyurish/patreon-mcp-server.git
cd patreon-mcp-server

# Install dependencies
uv sync

# Test it runs
PATREON_ACCESS_TOKEN=your_token uv run src/patreon_mcp_server/server.py

项目结构

src/patreon_mcp_server/
  server.py        # Entry point
  mcp_server.py    # FastMCP init + client instance
  tools.py         # @mcp.tool() definitions
  models.py        # Pydantic models + JSON:API parsers
  utils/
    client.py      # PatreonClient (HTTP layer)

路线图

此服务目前为只读。如果需求足够高，将添加写入操作（创建帖子、管理等级、向支持者发送消息）——提交 issue 或为仓库点亮星标以表达兴趣。

许可证

MIT 许可证——详情请参阅 LICENSE。

支持

如果你觉得这个项目有用，可以考虑在 Patreon 上支持开发工作。