usgs-quakes-mcp

用于 USGS Quakes API 的 Claude MCP 服务器

一个 MCP 服务器实现，用于在 Claude Desktop 中提供对 USGS Quakes API 的访问。

概述

此模型上下文协议 (MCP) 服务器使 AI 助手和应用程序能够：

• 通过各种搜索参数获取地震数据
• 获取有关特定地震的详细信息

用户可以使用自然语言运行查询。

示例输出

问：查找过去 20 年佛罗里达州 2 级以上地震

答： 我将帮助您搜索过去 20 年佛罗里达州震级大于 2.0 的地震。

查看来自 usgs-quakes (本地) 的 find-earthquakes 的结果

{
  "endTime": "2024-12-28T23:59:59",
  "startTime": "2004-12-28T00:00:00",
  "maxLatitude": 31.000888,
  "minLatitude": 24.396308,
  "maxLongitude": -80.031362,
  "minLongitude": -87.634896,
  "minmagnitude": 2
}

根据美国地质调查局的地震数据，过去 20 年在佛罗里达州或附近发生了三次值得注意的地震：

1. 2006 年 9 月 10 日墨西哥湾发生 5.9 级地震 位于离岸，坐标为 26.319°N, 86.606°W 深度：14 公里 这是该地区在此期间发生的最大地震 震感强烈，有 5,763 人报告感觉到了地震

2. 2019 年 3 月 6 日佛罗里达州杰伊附近发生 2.8 级地震 位于坐标 30.9718°N, 87.1719°W 深度：5 公里 49 人报告感觉到了这次地震

3. 2019 年 3 月 24 日佛罗里达州世纪城附近发生 2.7 级地震 位于坐标 30.9622°N, 87.2384°W 深度：5 公里 4 人报告感觉到了这次地震

值得注意的是，与美国地震活动更频繁的地区相比，佛罗里达州发生的地震相对较少。 2019 年发生的两次地震发生在佛罗里达州狭长地带，而 2006 年发生的较大地震则发生在墨西哥湾的离岸地区。

问：获取佛罗里达州杰伊地震的详细信息

答： 我将获取有关发生在佛罗里达州杰伊附近的 2.8 级地震的详细信息。

查看来自 usgs-quakes (本地) 的 find-earthquake-details 的结果

{
  "eventid": "us1000jbw4"
}

以下是有关佛罗里达州杰伊地震的主要细节： 日期和时间：2019 年 3 月 7 日，世界标准时间 04:45:52 地点：佛罗里达州杰伊西北 2 公里（1.2 英里） 坐标：30.9718°N, 87.1719°W 深度：5 公里（3.1 英里） 震级：2.8 mb_lg（体波震级）

其他细节：

• 49 人报告感觉到了地震
• 社区互联网强度图 (CIIM) 显示最大强度为 2.7
• 没有发生海啸
• 地震经过美国地质调查局科学家的审查和确认
• 该位置的水平误差幅度约为 6.2 公里
• 震级计算使用了来自 11 个地震台的数据
• 新墨西哥州地震网络 (NM) 也检测到了地震，该网络计算出的震级略有不同，为 2.63

技术测量：

• 方位角间隙：243 度（表示地震台的覆盖范围适中）
• 均方根误差：0.59（表示位置估计的质量合理）
• 到最近站点的最小距离：0.222 度
• 震级标准误差：0.154

这是一次相对较小的地震，但对于很少发生地震活动的佛罗里达州来说，值得注意。 49 人感觉到了地震这一事实表明，附近居民注意到了地震，尽管预计这种震级的地震不会造成重大破坏。

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 USGS 地震数据：

npx -y @smithery/cli install @blake365/usgs-quakes-mcp --client claude

手动安装

如果您不熟悉 Node.js 和 MCP 协议，安装可能会很棘手。

1. 安装 Node.js
2. 将此存储库克隆到本地计算机上的文件夹
3. 服务器已经构建完成，因此您可以跳过构建步骤。

额外步骤

如果您想对服务器进行更改，可以通过编辑 src/index.ts 文件来实现。

• 运行 npm install 安装依赖项
• 运行 npm run build 构建服务器
• 进行更改后，退出并重新启动 Claude Desktop

与 Claude Desktop 连接

1. 在以下位置打开您的 Claude Desktop 配置：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 添加服务器配置：

{
    "mcpServers": {
        "usgs-quakes": {
            "command": "node",
            "args": [
                "/Full/Route/to/Folder/usgs-quakes/build/index.js"
            ]
        }
    }
}

3. 关闭/退出然后重新启动 Claude Desktop

重新启动后，您应该在文本框的右下角看到一个小锤子图标。 如果您将鼠标悬停在该图标上，您将看到可用的 MCP 工具的数量。

故障排除

如果在运行服务器时遇到错误，您可能需要提供 node 命令的完整路径。 例如，在 macOS 上：/usr/local/bin/node