使用说明

项目简介

USGS Earthquake Data MCP 服务器是一个允许 AI 助手（如 Claude）访问美国地质调查局（USGS）地震数据 API 的工具。通过该服务器，用户可以使用自然语言查询最新的地震信息和详细数据。

主要功能点

查询地震数据：根据多种参数（如时间范围、地理位置、震级等）搜索地震事件。
获取地震详情：获取特定地震事件的详细信息，包括震级、位置、时间、深度等详细参数。

安装步骤

安装 Node.js：确保您的计算机上已安装 Node.js 运行环境。

克隆仓库到本地：使用 Git 将仓库 'https://github.com/blake365/usgs-quakes-mcp.git' 克隆到您的本地计算机。您可以使用以下命令：

git clone https://github.com/blake365/usgs-quakes-mcp.git

进入仓库目录：打开终端或命令提示符，导航到您克隆的仓库目录 'usgs-quakes-mcp'。
安装依赖：在仓库目录下运行以下命令安装项目依赖：
```
npm install
```
构建项目（如果修改了源代码）：如果您修改了 'src/index.ts' 文件，需要运行以下命令构建项目：
```
npm run build
```

服务器配置

要将此 MCP 服务器连接到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的服务器设置。以下是配置示例，您需要根据您的实际文件路径进行调整。

打开您的 MCP 客户端配置文件（以 Claude Desktop 为例，配置文件路径通常为 '~/Library/Application Support/Claude/claude_desktop_config.json' (macOS) 或 '%APPDATA%\Claude\claude_desktop_config.json' (Windows)），添加以下 'mcpServers' 配置：

{
    "mcpServers": {
        "usgs-quakes": {
            "command": "node",
            "args": [
                "/Full/Route/to/Folder/usgs-quakes-mcp/build/index.js"  // 将 "/Full/Route/to/Folder/usgs-quakes-mcp" 替换为仓库的实际路径
            ]
        }
    }
}

注意：

请将 '/Full/Route/to/Folder/usgs-quakes-mcp' 替换为 'usgs-quakes-mcp' 仓库在您本地文件系统中的绝对路径。例如，如果您的仓库位于 '/Users/YourUsername/Documents/usgs-quakes-mcp'，则应将路径更改为 '/Users/YourUsername/Documents/usgs-quakes-mcp/build/index.js'。
'command' 字段指定了用于启动服务器的命令，这里是 'node'，假设您的 Node.js 可执行文件在系统 PATH 环境变量中。如果 'node' 命令无法直接运行，您可能需要提供 Node.js 可执行文件的完整路径，例如 '/usr/local/bin/node' (macOS) 或 'C:\Program Files\nodejs\node.exe' (Windows)。

配置完成后，重启您的 MCP 客户端 (Claude Desktop)。

基本使用方法

启动 MCP 服务器：当您启动配置了 USGS Earthquake Data MCP 服务器的 MCP 客户端后，服务器通常会自动在后台启动。
使用自然语言查询：在 MCP 客户端中，您可以使用自然语言向 AI 助手提问关于地震的问题。服务器将通过提供的工具处理您的请求并返回地震数据。例如：
- "find earthquakes over magnitude 6 near Japan in the last month" (查找上个月在日本附近震级超过 6 级的地震)
- "get details for earthquake event with id us1000jbw4" (获取事件ID为 us1000jbw4 的地震详情)

AI 助手会将您的自然语言问题转换为对 MCP 服务器工具的调用，并返回从 USGS 地震数据 API 获取的地震信息。您可以通过客户端界面查看查询结果。

关键词