-
securityA
license-
qualityMCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
Last updated -
2
3
MIT License
Facebook 広告 MCP サーバー
このプロジェクトは、Facebook 広告へのインターフェースとして機能する MCP サーバーを提供し、Facebook 広告のデータと管理機能へのプログラムによるアクセスを可能にします。
お使いのブラウザはビデオタグをサポートしていません。
簡単なワンクリックセットアップ
セットアップをより簡単にするために、すぐに使用できるインストーラーを提供しています。
⊞ Windows: 👉 gomarble_mcp_tools.exe をダウンロード
MacOS: 👉 gomarble_mcp_tools.pkg をダウンロード
何をするのか
MCP サーバーをローカルにインストールして構成します
環境設定を自動的に処理します
プロセス中にFacebookトークン認証を求めるプロンプトが表示されますが、これはオプションです。
Facebookのアクセストークンが提供されていない場合は、GoMarbleのサーバーに接続して、代わりにトークンを作成します。
重要な免責事項
この設定では、Facebook 開発者アクセス トークンを手動で取得する必要はありません。
代わりに、 GoMarbleのサーバーに安全に接続し、ユーザーに代わってトークンを作成します。GoMarbleはトークンを保管しません。トークンはMCPサーバーで使用するために、ユーザーのマシンにローカルに保存されます。
設定
前提条件
Python 3.10以上
requirements.txtにリストされている依存関係
(オプションですが推奨) 仮想環境を作成してアクティブ化します。
python3 -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`仮想環境を使用すると、プロジェクトの依存関係をきれいに管理できます[ソース] 。
依存関係をインストールします:
pip install -r requirements.txt**Facebookアクセストークンの取得：**必要な権限（例：
ads_read）を持つFacebookユーザーアクセストークンを取得してください。これはFacebook開発者ポータルから生成できます。こちらのリンクをクリックしてください。
MCP クライアント (例: Cursor、Claude Desktop) での使用
このサーバーをMCP対応クライアントと統合するには、以下のような設定（ Claude ）を追加してください。YOUR_FACEBOOK_ACCESS_TOKEN YOUR_FACEBOOK_ACCESS_TOKEN実際のトークンに置き換え、必要に応じてserver.pyへのパスを調整してください。
{
"mcpServers": {
"fb-ads-mcp-server": {
"command": "python",
"args": [
"/path/to/your/fb-ads-mcp-server/server.py",
"--fb-token",
"YOUR_FACEBOOK_ACCESS_TOKEN"
]
// If using a virtual environment, you might need to specify the python executable within the venv:
// "command": "/path/to/your/fb-ads-mcp-server/venv/bin/python",
// "args": [
// "/path/to/your/fb-ads-mcp-server/server.py",
// "--fb-token",
// "YOUR_FACEBOOK_ACCESS_TOKEN"
// ]
}
}
}
構成を更新した後、MCP クライアント アプリを再起動します。
(注: Windows では、設定に応じてコマンド構造を調整するか、
サーバーのデバッグ
--fb-token引数を介してアクセス トークンを指定して、 server.pyを実行します。
python server.py --fb-token YOUR_FACEBOOK_ACCESS_TOKEN
利用可能なMCPツール
この MCP サーバーは、Facebook 広告のオブジェクトやデータを操作するためのツールを提供します。
ツール名 | 説明 |
アカウントとオブジェクトの読み取り | |
| トークンにリンクされた広告アカウントを一覧表示します。 |
| 特定の広告アカウントの詳細を取得します。 |
| 特定のキャンペーンの詳細を取得します。 |
| 特定の広告セットの詳細を取得します。 |
| 特定の広告の詳細を取得します。 |
| 特定の広告クリエイティブの詳細を取得します。 |
| 複数の広告セットの詳細を ID 別に取得します。 |
コレクションの取得 | |
| 広告アカウント内のキャンペーンを取得します。 |
| 広告アカウント内の広告セットを取得します。 |
| 広告アカウント内の広告を取得します。 |
| キャンペーン内の広告セットを取得します。 |
| キャンペーン内の広告を取得します。 |
| 広告セット内の広告を取得します。 |
| 広告に関連付けられたクリエイティブを取得します。 |
洞察とパフォーマンスデータ | |
| 広告アカウントのパフォーマンス分析情報を取得します。 |
| キャンペーンのパフォーマンス分析情報を取得します。 |
| 広告セットのパフォーマンス分析情報を取得します。 |
| 広告のパフォーマンス分析情報を取得します。 |
| ページネーション URL (例: Insights) からデータを取得します。 |
アクティビティ/変更履歴 | |
| 広告アカウントの変更履歴を取得します。 |
| 広告セットの変更履歴を取得します。 |
(注: ほとんどのツールは、
(注: Facebook アクセス トークンの有効期限が切れた場合は、新しいトークンを生成し、新しいトークンを使用して MCP クライアントの構成ファイルを更新して、ツールを引き続き使用する必要があります。)
依存関係
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています。
Smithery経由でインストール
Smithery経由で Claude Desktop 用の Facebook 広告サーバーを自動的にインストールするには:
npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude
This server cannot be installed
Related Resources
Related MCP Servers
- PythonMIT License
- -securityFlicense-qualityAn MCP server that enables interaction with Google's Display & Video 360 advertising platform API, allowing management of digital advertising campaigns through natural language commands.Last updated -
- -securityAlicense-qualityFacebook Ads MCP Server by CDataLast updated -MIT License