项目简介

Macrostrat MCP服务器是一个基于Model Context Protocol (MCP) 的服务器实现,它允许AI助手和应用程序访问 Macrostrat API 提供的全面的地质数据和信息。通过此服务器,用户可以使用自然语言查询地质单元、地层柱状图、矿物、时间尺度等信息,进行地质数据分析,并用于改进地质学理解和创建相关图形。

主要功能点

  • 资源 (Resources) 管理: 提供地质数据模式 (schema) 的描述,例如地质单元 (units)、地层柱状图 (columns) 和矿物 (minerals) 的JSON Schema。
  • 工具 (Tools) 注册与执行: 注册了一系列工具,允许LLM客户端查询Macrostrat API,包括:
    • 'find-columns': 查询地层柱状图
    • 'find-units': 查询地质单元
    • 'defs': 访问Macrostrat定义的标准字段和字典
    • 'defs-autocomplete': 快速检索匹配查询的所有定义
    • 'mineral-info': 获取矿物信息
    • 'timescale': 获取时间周期信息
  • Prompt 模板 (Prompts) 定义: 定义了Prompt模板,支持用户以可定制的方式与LLM进行交互,例如:
    • 'geologic-history': 获取某个位置的地质历史
    • 'bedrock': 获取基岩地质信息

安装步骤

  1. 安装 Node.js: 访问 Node.js官网 下载并安装 Node.js。
  2. 克隆仓库: 使用 'git clone https://github.com/blake365/macrostrat-mcp' 命令将仓库克隆到本地。
  3. 无需构建: 服务器已预先构建,跳过构建步骤。

服务器配置

要将此MCP服务器连接到MCP客户端(例如 Claude Desktop),您需要编辑客户端的配置文件。以 Claude Desktop 为例,您需要修改 'claude_desktop_config.json' 文件,根据您的操作系统,该文件通常位于:

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

在 'mcpServers' 字段中添加以下配置,指定服务器名称 ('macrostrat') 以及启动服务器的命令 ('command') 和参数 ('args'):

{
    "mcpServers": {
        "macrostrat": {
            "command": "node",
            "args": [
                "/Full/Route/to/Folder/macrostrat/build/index.js"  // 将 "/Full/Route/to/Folder/macrostrat" 替换为您的本地仓库路径
            ]
        }
    }
}

参数注释:

  • '"command": "node"': 指定用于启动服务器的命令为 'node' (Node.js 运行时环境)。
  • '"args": ["/Full/Route/to/Folder/macrostrat/build/index.js"]': 指定传递给 'node' 命令的参数,即服务器入口文件 'build/index.js' 的完整路径。请务必将 '/Full/Route/to/Folder/macrostrat' 替换为您本地克隆仓库的绝对路径。

注意: 如果启动服务器时遇到 'node' 命令找不到的错误,您可能需要提供 'node' 命令的完整路径,例如 macOS 上可能是 '/usr/local/bin/node'。

基本使用方法

配置完成后,重启 MCP 客户端 (如 Claude Desktop)。成功连接后,客户端通常会在界面上显示MCP服务器提供的工具和Prompt。您可以通过自然语言与客户端交互,客户端会根据您的指令调用 MCP 服务器提供的工具和Prompt,查询 Macrostrat API 获取地质数据,并将结果返回给您。

例如,您可以向 Claude Desktop 提出类似以下的问题:

  • "What is the geologic history of Nashville, TN?" (纳什维尔,田纳西州的地质历史是什么?)
  • "What is the bedrock geology of Denver, CO?" (丹佛,科罗拉多州的基岩地质是什么?)

客户端会自动识别并调用相应的 Prompt 和 Tool 来处理您的请求,并返回地质信息。

信息

分类

网页与API