ローカル Falcon MCP サーバー
Local Falcon API用のMCP（モデルコンテキストプロトコル）サーバー。TypeScriptで実装され、公式MCP SDKを使用しています。このサーバーは、Local Falconのレポート機能をMCPツールとして公開し、エージェント型AIシステムやワークフローとの統合を可能にします。
前提条件
Claude Desktop を使い始める
- MCP サーバーの新しいディレクトリを作成し、パッケージをインストールします。
mkdir lf-mcp
cd lf-mcp
npm i @local-falcon/mcp
- インストールされた npm モジュールへのパスをコピーし、/dist の下の index.js ファイルを指すようにして、mcp.json ファイル内の args に追加します。
- mcp.json ファイルの env に API キーを追加します。
STDIO経由で実行
MacOS/Unix の場合は次の形式を使用します。
{
"mcpServers": {
"local-falcon-mcp": {
"command": "node",
"args": ["/Users/YOUR_USERNAME/lf-mcp/node_modules/@local-falcon/mcp/dist/index.js"],
"env": {
"LOCALFALCON_API_KEY": "INSERT_YOUR_API_KEY_HERE"
}
}
}
}
Windows の場合は次の形式を使用します。
{
"mcpServers": {
"local-falcon-mcp": {
"command": "node",
"args": ["C:\\Users\\YOUR_USERNAME\\lf-mcp\\node_modules\\@local-falcon\\mcp\\dist\\index.js"],
"env": {
"LOCALFALCON_API_KEY": "INSERT_YOUR_API_KEY_HERE"
}
}
}
}
STDIOゲートウェイ経由でSSE経由で実行
すべてのプラットフォームで次の形式を使用します。
{
"mcpServers": {
"local-falcon-mcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.localfalcon.com/sse?local_falcon_api_key=INSERT_YOUR_API_KEY_HERE"
]
}
}
}
プロユーザー
Claude Max/Teamユーザーの場合、MCPツールの呼び出し回数制限が緩和されます。この機能を有効にするには、URLのクエリ文字列にis_pro=trueを追加する必要があります。例：
{
"mcpServers": {
"local-falcon-mcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.localfalcon.com/sse?local_falcon_api_key=INSERT_YOUR_API_KEY_HERE&is_pro=true"
]
}
}
}
Claude Integrations (SSE) 経由で実行
Claude 統合に接続する場合:
- サーバーに
Local Falcon MCPという名前を付けます - 次の 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 ホスト アプリケーションで実行するために必要):
- MCP Inspector を実行します。
- MCP サーバーを実行します。次のいずれかを実行します。
bun run start
bun run start:sse
bun run start:stdio
ライセンス
マサチューセッツ工科大学
謝辞