本地猎鹰MCP服务器

这是一个为本地猎鹰API实现的MCP（模型上下文协议）服务器，使用TypeScript编写，并利用了官方MCP SDK。此服务器将本地猎鹰的报告功能作为MCP工具暴露出来，从而能够与代理型AI系统和工作流集成。

先决条件

• Node.js（安装LTS版本）

在Claude桌面版中开始

1. 为MCP服务器创建一个新的目录并安装包。
   bash
   mkdir lf-mcp
   cd lf-mcp
   npm i @local-falcon/mcp

2. 复制已安装npm模块的路径，并将其添加到mcp.json文件中的args部分，确保指向/dist下的index.js文件。

3. 将您的API密钥添加到mcp.json文件中的env部分。

通过STDIO运行

对于MacOS/Unix，请使用以下格式：
json
{
"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，请使用以下格式：
json
{
"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"
}
}
}
}

通过SSE经由STDIO网关运行

对于所有平台，请使用以下格式：

json
{
"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来启用。例如：

json
{
"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集成（SSE）运行

如果连接到Claude集成：

1. 将服务器命名为Local Falcon MCP
2. 添加如下URL: https://mcp.localfalcon.com/sse?local_falcon_api_key=YOUR_API_KEY_HERE

工具列表

• listLocalFalconScanReports: 检索您的本地猎鹰账户执行的所有扫描报告列表。
• listLocalFalconTrendReports: 检索您的本地猎鹰账户执行的所有趋势报告列表。
• listLocalFalconAutoScans: 检索所有自动扫描列表。
• listAllLocalFalconLocations: 检索所有位置列表。
• listLocalFalconLocationReports: 检索所有位置报告列表。
• getLocalFalconLocationReport: 检索单个位置报告。位置报告看起来像这样：https://www.localfalcon.com/reports/location/view/c60c325a8665c4a，其中c60c325a8665c4a是报告密钥。
• getLocalFalconReport: 根据报告密钥检索单个本地猎鹰扫描报告。仅读取返回报告中的AI分析部分。否则，AI分析将不会存在。用户还可以以https://www.localfalcon.com/reports/view/0b38313fa35c37f的形式输入报告密钥，其中0b38313fa35c37f是报告密钥。
• getLocalFalconTrendReport: 检索单个本地猎鹰趋势报告。趋势报告看起来像这样：https://www.localfalcon.com/reports/trend/view/95290829819f6e8，其中95290829819f6e8是报告密钥。
• listLocalFalconKeywordReports: 检索所有关键词报告列表。关键词报告看起来像这样：https://www.localfalcon.com/reports/keyword/view/754ffcb0f309938，其中754ffcb0f309938是报告密钥。
• getLocalFalconKeywordReport: 检索单个本地猎鹰关键词报告。
• getLocalFalconGrid: 一个辅助方法，用于创建本地猎鹰网格。
• getLocalFalconGoogleBusinessLocations: 获取本地猎鹰Google Business位置。* getLocalFalconRankingAtCoordinate: 在指定坐标点检索搜索结果，并获取指定业务的排名数据。
• getLocalFalconKeywordAtCoordinate: 在指定坐标点检索搜索结果，但不包含任何排名比较数据。
• runLocalFalconFullGridSearch: 使用传递的关键字或搜索词进行全网格搜索，以匹配指定的业务。
• getLocalFalconCompetitorReports: 检索您在 Local Falcon 账户中的所有竞争对手报告列表。
• getLocalFalconCompetitorReport: 从您的 Local Falcon 账户中特定的竞争对手报告中检索最多 20 个竞争对手企业。
• listLocalFalconCampaignReports: 检索您在 Local Falcon 账户中的所有位置报告列表。
• getLocalFalconCampaignReport: 从您的 Local Falcon 账户中检索某个 Campaign 的完整报告。
• listLocalFalconGuardReports: 检索您在 Local Falcon 账户中的所有 Falcon Guard 报告列表。
• getLocalFalconGuardReport: 根据给定的 place_id 从您的 Local Falcon 账户中检索某个 Falcon Guard 报告的完整报告。

对于开发者

• 构建（在本地 MCP 主机应用程序中运行所必需）：

  bash
  bun run build

• 运行 MCP Inspector：
  bash
  bun run inspector

• 运行 MCP 服务器：

  运行以下命令之一：

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

  注意：如果未指定 sse，则服务器将默认使用 stdio。

许可证

MIT

致谢

• Local Falcon API
• Model Context Protocol (MCP)
• Bun