Patreon

Patreon MCP サーバー

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

AI アシスタントから Patreon のクリエイターデータにアクセスできます。認証に対応した初の Patreon MCP サーバーです。Claude Desktop、Cursor、Windsurf、VS Code Copilot、その他 MCP 対応クライアントで使用できます。

クイックスタート

1. Creator Access Token を取得する

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	ページ分割されたパトロン一覧（1ページあたり100件）	MemberPage
fetch_posts	ページ分割された投稿一覧（1ページあたり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's Creator Privacy Promise および適用されるデータ保護法に準拠した利用を確保する責任は、利用者にあります。

このプロジェクトは 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 です。詳細は LICENSE をご覧ください。

サポート

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