Локальный сервер Falcon MCP

Сервер MCP (Model Context Protocol) для Local Falcon API , реализованный на TypeScript с использованием официального MCP SDK. Этот сервер предоставляет возможности создания отчетов Local Falcon в качестве инструментов MCP, обеспечивая интеграцию с агентскими системами ИИ и рабочими процессами.

Предпосылки

• Node.js (установить версию LTS)

Начало работы в Claude Desktop

1. Создайте новый каталог для сервера MCP и установите пакет.

2. Скопируйте путь к установленному модулю npm и добавьте его в аргументы в файле mcp.json, убедившись, что он указывает на файл index.js в каталоге /dist.

3. Добавьте свой ключ API в env в файле mcp.json.

Related MCP server: Google Search Console MCP

Запуск через STDIO

Для MacOS/Unix используйте следующий формат:

Для Windows используйте следующий формат:

Запуск через SSE через шлюз STDIO

Для всех платформ используйте следующий формат:

Профессиональные пользователи

Для пользователей Claude Max/Team вы разблокируете больший лимит вызова инструмента MCP. Это должно быть включено путем добавления is_pro=true в строку запроса URL. Например:

Работает через 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 по ключу отчета. Читает только анализ AI возвращенного отчета. В противном случае сообщает об отсутствии анализа AI. Пользователи также могут ввести ключ отчета в формате https://www.localfalcon.com/reports/view/0b38313fa35c37f , где 0b38313fa35c37f — ключ отчета.

• getLocalFalconTrendReport: Извлекает один отчет о тенденциях Local Falcon. Отчет о тенденциях выглядит как https://www.localfalcon.com/reports/trend/view/95290829819f6e8 , где 95290829819f6e8 — ключ отчета.

• listLocalFalconKeywordReports: Извлекает список всех отчетов по ключевым словам. Отчет по ключевым словам выглядит как https://www.localfalcon.com/reports/keyword/view/754ffcb0f309938 , где 754ffcb0f309938 — ключ отчета.

• getLocalFalconKeywordReport: извлекает один отчет по ключевым словам Local Falcon.

• getLocalFalconGrid: вспомогательный метод для создания локальной сетки Falcon.

• getLocalFalconGoogleBusinessLocations: извлекает локальные местоположения Falcon Google Business.

• getLocalFalconRankingAtCoordinate: извлекает результаты поиска в указанной точке координат и получает данные рейтинга для указанной компании.

• getLocalFalconKeywordAtCoordinate: извлекает результаты поиска в указанной точке координат без каких-либо данных сравнения рангов.

• runLocalFalconFullGridSearch: выполняет полный поиск по сетке, используя переданное ключевое слово или поисковый термин для сопоставления с указанным предприятием.

• getLocalFalconCompetitorReports: получает список всех отчетов о конкурентах в вашей учетной записи Local Falcon.

• getLocalFalconCompetitorReport: извлекает до 20 компаний-конкурентов из определенного отчета о конкурентах из вашей учетной записи Local Falcon.

• listLocalFalconCampaignReports: получает список всех отчетов о местоположении в вашей учетной записи Local Falcon.

• getLocalFalconCampaignReport: получает полный отчет о кампании из вашей учетной записи Local Falcon.

• listLocalFalconGuardReports: получает список всех отчетов Falcon Guard в вашей учетной записи Local Falcon.

• getLocalFalconGuardReport: извлекает полный отчет Falcon Guard из вашей учетной записи Local Falcon по указанному place_id.

Для разработчиков

• Сборка (необходима для запуска в локальных хост-приложениях MCP):

  bun run build

• Запустите MCP Inspector:

  bun run inspector

• Запустите MCP-сервер:

  Выполните одно из следующих действий:

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

  Примечание: если sse не указан, сервер по умолчанию будет использовать stdio.

Лицензия

Массачусетский технологический институт

Благодарности

• Локальный API Falcon

• Модель контекстного протокола (MCP)

• Булочка