Patreon MCP Server

🚀 Patreon MCP Server

AIアシスタントにPatreonのクリエイターデータへのアクセスを提供します。初めての認証済みPatreon MCPサーバーで、Claude Desktop、Cursor、Windsurf、VS Code Copilot、およびMCP互換のクライアントと連携します。

🚀 クイックスタート

1. クリエイターアクセストークンを取得する

Patreon Developer Portalにアクセスし、クリエイターアクセストークンをコピーします。このトークンは、あなた自身のキャンペーンデータにのみアクセスできます。

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パラメータとして渡します。

📚 データフィールド

メンバー

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とは関係がなく、承認もされていません。

📦 インストール

前提条件

• 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レイヤー)

🚧 ロードマップ

このサーバーは現在読み取り専用です。書き込み操作（投稿の作成、階層の管理、パトロンへのメッセージ送信）は、十分な需要があれば追加されます。興味を示すには、issueを作成するか、リポジトリにスターを付けてください。

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。

🤝 サポート

このプロジェクトが役に立った場合は、Patreon で開発を支援することを検討してください。