Patreon MCP Server

🚀 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_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 上支持項目開發。