macrostrat-mcp

macrostrat-mcp

Macrostrat API 的 MCP 服务

一个 MCP 服务，可从 Claude Desktop、Claude Code 及任何其他 MCP 客户端访问 Macrostrat API。

npx -y macrostrat-mcp

无需 API 密钥 — Macrostrat API 免费且公开。

概述

此模型上下文协议（MCP）服务使 AI 助手和应用能够：

• 查询 Macrostrat API 提供的全面地质数据和信息
• 访问地质单元、剖面、矿物、时间尺度等
• 获取大模型能够解读的地质地图图块（实用性存疑，但可能对某些应用有用）
• 分析地质数据，以加深对地质的理解
• 根据数据创建图形并进行数据分析

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

示例输出

Q. Nashville, TN 的地质历史是什么？

A. 让我查询一下 Nashville 所在位置的地质数据。

查看 macrostrat 中 find-units 的结果（本地）

{
  "lat": 36.1627,
  "lng": -86.7816,
  "responseType": "long"
}

田纳西州 Nashville 的地质历史

1. 中元古代基底（16 亿至 11 亿年前）

• 火成基底岩（花岗岩和流纹岩）
• 属于古老的北美克拉通

2. 早—中寒武世（5.18 亿至 5.04 亿年前）

• Rome 组：碳酸盐—硅质碎屑混合沉积物
• 浅海环境
• 属于正在形成的大陆架

3. 中—晚寒武世（5.04 亿至 4.98 亿年前）

• Conasauga 组：石灰岩和混合沉积物
• 海相沉积持续进行
• 石灰岩与页岩交替，表明海平面波动

4. 晚寒武世—早奥陶世（4.98 亿至 4.7 亿年前）

• Knox 白云岩：厚层白云岩序列
• 广阔的浅海台地
• 厚达 1,200 米
• 代表长期稳定的海相环境

5. 中—晚奥陶世（4.7 亿至 4.43 亿年前） 若干重要地层：

• Stones River 群（包括 Murfreesboro、Pierce、Lebanon 石灰岩）
• Nashville 群（包括 Hermitage、Bigby-Cannon、Catheys 组）
• 以石灰岩沉积为主
• 富含化石
• 浅海环境
• 多个海平面变化周期

6. 早—中志留世（4.43 亿至 4.23 亿年前）

• 从 Brassfield 组至 Decatur 组
• 海相石灰岩沉积持续进行
• 海相环境多样，从浅水到深水均有

7. 中泥盆世—早密西西比世（3.9 亿至 3.57 亿年前）

• 从 Pegram 组至 Chattanooga 页岩
• 转为以碎屑（页岩）沉积为主
• Chattanooga 页岩代表较深、缺氧的环境

8. 早—晚密西西比世（3.57 亿至 3.31 亿年前） 若干石灰岩地层：

• Fort Payne 组
• Warsaw 石灰岩
• St. Louis 石灰岩
• Monteagle 石灰岩
• Hartselle 组
• 恢复为碳酸盐台地环境
• 海相环境多样

9. 新生代至今

• 长期侵蚀与地表出露
• 形成现今地貌
• Nashville 穹窿构造形成
• 河流与溪流沉积

主要特征

• 该地区在地质历史的大部分时期都以海相环境为主
• 以石灰岩地层为主，表明当时为温暖的浅海
• 经历多个海平面变化周期
• 化石记录丰富，奥陶纪岩石尤为突出
• 属于 Nashville 穹窿构造特征的一部分
• 长期侵蚀移除了较年轻的岩石
• 现今地形由不同石灰岩单元的差异侵蚀塑造

当今的基岩

如今纳什维尔的基岩主要由出露于地表的奥陶纪石灰岩地层构成，尤其是 Stones River 和 Nashville Group 石灰岩。这些岩石在许多地区广泛出露，并影响了当地喀斯特地形的形成，包括该地区常见的洞穴和天坑。

安装

需要 Node.js 20 或更高版本。无需安装步骤——首次运行时，npx 会获取该服务。

Claude Desktop

1. 打开 Claude Desktop 配置文件：

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

2. 添加服务配置：

{
    "mcpServers": {
        "macrostrat": {
            "command": "npx",
            "args": ["-y", "macrostrat-mcp"]
        }
    }
}

3. 关闭并退出，然后重启 Claude Desktop

重启后，你应该会看到搜索和工具图标。点击此按钮即可查看可用的 MCP 工具。

Claude Code

claude mcp add macrostrat -- npx -y macrostrat-mcp

其他任何 MCP 客户端

该服务通过 STDIO 使用 MCP。使用 npx -y macrostrat-mcp 运行，或使用 npm install -g macrostrat-mcp 全局安装后运行 macrostrat-mcp。

开发

npm install        # install dependencies
npm run dev        # run from source over STDIO, no build step
npm run build      # compile TypeScript to build/
npm run typecheck  # type-check without emitting

src/server.ts 包含所有工具、提示词和 API 调用——需要编辑的就是这个文件。 src/index.ts 只是 STDIO 入口点。

若要让 Claude Desktop 使用本地构建版本，而非已发布的软件包，请将 "command": "node" 与 "args": ["/full/path/to/macrostrat/build/index.js"] 配合使用，并在每次重新构建后重启 Claude Desktop。

将其用作库

如果想接入其他传输方式，可以使用导出的服务工厂：

import createServer from "macrostrat-mcp";

const server = createServer();
await server.connect(yourTransport);

故障排除

如果 Claude Desktop 找不到 npx，请提供其完整路径（在 macOS 上通常为 /usr/local/bin/npx 或 /opt/homebrew/bin/npx）。如果运行的是本地构建版本，node 也需要提供完整路径。