Servidor MCP Macrostrat | Awesome MCP Servers

macrostrat-mcp

Servidor MCP para a API Macrostrat

Um servidor MCP que fornece acesso à API Macrostrat a partir do Claude Desktop, Claude Code e qualquer outro cliente MCP.

npx -y macrostrat-mcp

Nenhuma chave de API é necessária — a API Macrostrat é gratuita e pública.

Visão Geral

Este servidor Model Context Protocol (MCP) permite que assistentes de IA e aplicações possam:

Consultar dados geológicos abrangentes e informações fornecidas pela API Macrostrat
Acessar unidades geológicas, colunas, minerais, escalas de tempo e muito mais
Obter tiles de mapas geológicos que o LLM pode interpretar (utilidade questionável, mas pode ser útil para algumas aplicações)
Analisar dados geológicos para melhorar a compreensão geológica
Criar gráficos e realizar análises de dados a partir dos dados

Os usuários podem executar consultas usando linguagem natural.

Exemplo de Saída

P. Qual é a história geológica de Nashville, TN?

R. Deixe-me verificar os dados geológicos para a localização de Nashville.

Ver resultado de find-units do macrostrat (local)

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

História Geológica de Nashville, Tennessee

Embasamento Mesoproterozoico (1,6–1,1 bilhões de anos atrás)

Rochas ígneas de embasamento (granito e riolito)
Parte do antigo cráton norte-americano

Cambriano Inferior–Médio (518–504 milhões de anos atrás)

Formação Rome: Sedimentos mistos carbonáticos-siliciclásticos
Ambiente marinho raso
Parte da plataforma continental em desenvolvimento

Cambriano Médio–Superior (504–498 milhões de anos atrás)

Formação Conasauga: Calcário e sedimentos mistos
Deposição marinha contínua
Alternância de calcário e folhelho indicando níveis do mar flutuantes

Cambriano Superior–Ordoviciano Inferior (498–470 milhões de anos atrás)

Dolomito Knox: Sequência maciça de dolomito
Plataforma marinha rasa extensa
Até 1.200 metros de espessura
Representa um longo período de condições marinhas estáveis

Ordoviciano Médio–Superior (470–443 milhões de anos atrás) Várias formações importantes:

Grupo Stones River (incluindo os Calcários Murfreesboro, Pierce e Lebanon)
Grupo Nashville (incluindo as Formações Hermitage, Bigby-Cannon e Catheys)
Principalmente depósitos de calcário
Rico em fósseis
Ambiente marinho raso
Múltiplos ciclos de mudança do nível do mar

Siluriano Inferior–Médio (443–423 milhões de anos atrás)

Formações Brassfield até Decatur
Deposição marinha contínua de calcário
Vários ambientes marinhos, de águas rasas a mais profundas

Devoniano Médio–Mississippiano Inferior (390–357 milhões de anos atrás)

Formação Pegram até o Folhelho Chattanooga
Mudança para deposição mais clástica (folhelho)
O Folhelho Chattanooga representa condições mais profundas e pobres em oxigênio

Mississippiano Inferior–Superior (357–331 milhões de anos atrás) Várias formações de calcário:

Formação Fort Payne
Calcário Warsaw
Calcário St. Louis
Calcário Monteagle
Formação Hartselle
Retorno às condições de plataforma carbonática
Ambientes marinhos diversos

Cenozoico até o Presente

Longo período de erosão e exposição
Desenvolvimento da paisagem atual
Formação da estrutura do Domo de Nashville
Depósitos de rios e córregos

Características Principais

A área foi predominantemente um ambiente marinho durante a maior parte de sua história geológica
Dominada por formações de calcário indicando mares quentes e rasos
Múltiplos ciclos de mudança do nível do mar
Rico registro fóssil, especialmente em rochas ordovicianas
Parte da característica estrutural do Domo de Nashville
Longos períodos de erosão removeram rochas mais jovens
Topografia atual moldada pela erosão diferencial de várias unidades de calcário

Rocha Matriz Atual

A rocha matriz de Nashville hoje consiste principalmente em formações de calcário ordoviciano expostas na superfície, particularmente os calcários dos Grupos Stones River e Nashville. Essas rochas estão bem expostas em muitas áreas e influenciaram o desenvolvimento da topografia cárstica local, incluindo cavernas e dolinas comuns na região.

Instalação

Requer Node.js 20 ou mais recente. Nenhuma etapa de instalação é necessária — npx busca o servidor na primeira execução.

Claude Desktop

Abra sua configuração do Claude Desktop em:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione a configuração do servidor:

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

Feche/Saia e reinicie o Claude Desktop

Após reiniciar, você deve ver um ícone para busca e ferramentas. Clique neste botão para ver as ferramentas MCP disponíveis.

Claude Code

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

Qualquer outro cliente MCP

O servidor fala MCP via STDIO. Execute-o com npx -y macrostrat-mcp, ou instale-o globalmente com npm install -g macrostrat-mcp e execute macrostrat-mcp.

Desenvolvimento

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 contém todas as ferramentas, prompts e chamadas de API — esse é o arquivo a ser editado. src/index.ts é apenas o ponto de entrada STDIO.

Para apontar o Claude Desktop para uma compilação local em vez do pacote publicado, use "command": "node" com "args": ["/full/path/to/macrostrat/build/index.js"], e reinicie o Claude Desktop após cada recompilação.

Usando como biblioteca

A fábrica do servidor é exportada se você quiser anexar um transporte diferente:

import createServer from "macrostrat-mcp";

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

Solução de Problemas

Se o Claude Desktop não conseguir encontrar npx, forneça o caminho completo (no macOS, normalmente /usr/local/bin/npx ou /opt/homebrew/bin/npx). O mesmo se aplica a node se você estiver executando uma compilação local.

Macrostrat

Documentação