Patreon数据访问服务器

Patreon MCP服务器是一项为AI助手提供Patreon创作者数据访问的服务,适用于需要管理Patreon活动的创作者。

  • by KyuRish
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 KyuRish/patreon-mcp-server

使用说明

Patreon MCP服务器

mcp名称:io.github。KyuRish/patreon mcp服务器

让AI助手访问您的Patreon创建者数据。第一个经过身份验证的Patreon MCP服务器-可与Claude Desktop、Cursor、Windsurf、VS Code Copilot和任何兼容MCP的客户端配合使用。

快速开始

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

首选 Patreon开发者门户 并复制您的 创建者访问令牌。此令牌仅允许访问您自己的活动数据。

2.配置您的MCP客户端

克劳德桌面版 -添加到 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"
      }
    }
  }
}

克劳德代码 -添加到 .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 返回a 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服务器本身不缓存或持久化任何数据

重要:当将此服务器与人工智能助手一起使用时,用户数据(姓名、质押金额、收费状态)会发送给您的人工智能提供商(例如Anthropic、OpenAI),并可能根据其数据处理政策临时保留。您有责任确保您的使用符合 Patreon的创作者隐私承诺 以及适用的数据保护法。

该项目不隶属于Patreon或得到Patreon的认可。

先决条件

# 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)

路线图

此服务器当前是只读的。如果有足够的需求,将添加写操作(创建帖子、管理层、向用户发送消息)- 打开一个问题 或者在回购中加星以示兴趣。

许可证

MIT许可证-请参阅 许可证 了解详情。

支持

如果您觉得这很有用,请考虑支持以下开发 Patreon.