ローカル Falcon MCP サーバー

Local Falcon API用のMCP（モデルコンテキストプロトコル）サーバー。TypeScriptで実装され、公式MCP SDKを使用しています。このサーバーは、Local Falconのレポート機能をMCPツールとして公開し、エージェント型AIシステムやワークフローとの統合を可能にします。

前提条件

• Node.js (LTS バージョンをインストール)

Claude Desktop を使い始める

1. MCP サーバーの新しいディレクトリを作成し、パッケージをインストールします。

2. インストールされた npm モジュールへのパスをコピーし、/dist の下の index.js ファイルを指すようにして、mcp.json ファイル内の args に追加します。

3. mcp.json ファイルの env に API キーを追加します。

Related MCP server: Google Search Console MCP

STDIO経由で実行

MacOS/Unix の場合は次の形式を使用します。

Windows の場合は次の形式を使用します。

STDIOゲートウェイ経由でSSE経由で実行

すべてのプラットフォームで次の形式を使用します。

プロユーザー

Claude Max/Teamユーザーの場合、MCPツールの呼び出し回数制限が緩和されます。この機能を有効にするには、URLのクエリ文字列にis_pro=trueを追加する必要があります。例：

Claude Integrations (SSE) 経由で実行

Claude 統合に接続する場合:

1. サーバーにLocal Falcon MCPという名前を付けます

2. 次の URL を追加します: https://mcp.localfalcon.com/sse?local\_falcon\_api\_key=YOUR\_API\_KEY\_HERE

ツールリスト

• listLocalFalconScanReports: Local Falcon アカウントによって実行されたすべてのスキャン レポートのリストを取得します。

• listLocalFalconTrendReports: Local Falcon アカウントによって実行されたすべてのトレンド レポートのリストを取得します。

• listLocalFalconAutoScans: すべての自動スキャンのリストを取得します。

• listAllLocalFalconLocations: すべての場所のリストを取得します。

• listLocalFalconLocationReports: すべての位置レポートのリストを取得します。

• getLocalFalconLocationReport: 単一の位置情報レポートを取得します。位置情報レポートはhttps://www.localfalcon.com/reports/location/view/c60c325a8665c4aのような形式で、c60c325a8665c4a がレポートキーです。

• getLocalFalconReport: レポートキーを指定して、Local Falconスキャンレポートを1件取得します。返されたレポートのAI分析のみを読み取ります。それ以外の場合は、AI分析は存在しないと報告されます。ユーザーは、 https://www.localfalcon.com/reports/view/0b38313fa35c37fという形式でレポートキーを入力することもできます。ここで、0b38313fa35c37f がレポートキーです。

• getLocalFalconTrendReport: Local Falconトレンドレポートを1件取得します。トレンドレポートはhttps://www.localfalcon.com/reports/trend/view/95290829819f6e8のような形式で、95290829819f6e8がレポートキーです。

• listLocalFalconKeywordReports: すべてのキーワードレポートのリストを取得します。キーワードレポートはhttps://www.localfalcon.com/reports/keyword/view/754ffcb0f309938のような形式で、754ffcb0f309938 がレポートキーです。

• getLocalFalconKeywordReport: 単一の Local Falcon キーワード レポートを取得します。

• getLocalFalconGrid: ローカル ファルコン グリッドを作成するためのヘルパー メソッド。

• getLocalFalconGoogleBusinessLocations: ローカル Falcon Google ビジネスの場所を取得します。

• getLocalFalconRankingAtCoordinate: 指定された座標点での検索結果を取得し、指定されたビジネスのランキングデータを取得します。

• getLocalFalconKeywordAtCoordinate: ランク比較データなしで、指定された座標ポイントの検索結果を取得します。

• runLocalFalconFullGridSearch: 渡されたキーワードまたは検索用語を使用して、指定されたビジネスと一致する完全なグリッド検索を取得します。

• getLocalFalconCompetitorReports: Local Falcon アカウント内のすべての競合レポートのリストを取得します。

• getLocalFalconCompetitorReport: Local Falcon アカウントの特定の競合レポートから最大 20 社の競合企業を取得します。

• listLocalFalconCampaignReports: Local Falcon アカウント内のすべてのロケーションレポートのリストを取得します。

• getLocalFalconCampaignReport: Local Falcon アカウントからキャンペーンの完全なレポートを取得します。

• listLocalFalconGuardReports: Local Falcon アカウント内のすべての Falcon Guard レポートのリストを取得します。

• getLocalFalconGuardReport: place_id を指定して、Local Falcon アカウントから Falcon Guard レポートの完全なレポートを取得します。

開発者向け

• ビルド (ローカル MCP ホスト アプリケーションで実行するために必要):

  bun run build

• MCP Inspector を実行します。

  bun run inspector

• MCP サーバーを実行します。

  次のいずれかを実行します。

  bun run start bun run start:sse bun run start:stdio

  注意: sse が指定されていない場合、サーバーはデフォルトで stdio になります。

ライセンス

マサチューセッツ工科大学

謝辞

• ローカルファルコンAPI

• モデルコンテキストプロトコル（MCP）

• パン