Macrostrat MCP

1 forks

0 stars

Free

What is macrostrat-mcp

macrostrat-mcp is a server developed by blake365 that leverages the Model Context Protocol (MCP) to provide seamless access to the Macrostrat API. This server is specifically designed to integrate with Claude Desktop, an AI platform. By using macrostrat-mcp, users can query and interact with extensive geological data, enabling a deeper understanding of earth sciences. The server acts as a bridge between the Macrostrat API and AI applications, allowing users to access geological units, timescales, and more using natural language queries.

How to Use macrostrat-mcp

Using macrostrat-mcp involves several steps to set it up with Claude Desktop:

Installation:
- Install the server using a package manager like Smithery, which streamlines the setup process. Execute the command to download and configure the server on your machine.
Configuration:
- After installation, you need to configure Claude Desktop to recognize and use the new server. This involves editing the configuration file specific to your operating system and adding the server details.
Running the Server:
- Once configured, restart Claude Desktop. Upon successful setup, you should see an indicator in the application interface showing the available MCP tools, including macrostrat-mcp.
Querying Data:
- You can now make natural language queries related to geological data directly through Claude Desktop. The server processes these queries and interacts with the Macrostrat API to fetch and display the necessary information.

Key Features of macrostrat-mcp

Seamless Integration: Easily integrates with Claude Desktop, enhancing AI capabilities with geologic data access.
Natural Language Queries: Allows users to query geological information using everyday language, making it accessible to non-experts.
Comprehensive Data Access: Provides access to a wide range of geological data, including units, minerals, and timescales.
Real-Time Information: Enables real-time data retrieval from the Macrostrat API, ensuring up-to-date information is available.
Flexible Customization: Users can modify the server code to suit specific needs, with options to install dependencies and build the server locally.
Rich Geological Insights: Offers detailed geological histories, such as the example of Nashville, TN, illustrating the server's ability to provide in-depth geologic analysis.
Secure and Standardized Protocol: Utilizes the open-source MCP framework to ensure secure and standardized data access between AI systems and external data sources.

By using macrostrat-mcp, users can transform their geological data interaction, making it more intuitive and aligned with modern AI capabilities. Whether for academic research, professional use, or personal interest, macrostrat-mcp opens new avenues for exploring and understanding our planet's geological past and present.

Claude MCP server for Macrostrat API An MCP server implementation for providing access to the Macrostrat API within Claude Desktop.

Overview

This Model Context Protocol (MCP) server enables AI assistants and applications to:

Query comprehensive geologic data and information provided by the Macrostrat API
Access geologic units, columns, minerals, timescales, and more
Analyze geologic data to improve geological understanding
Create graphics and perform data analysis from the data Users can run queries using natural language.

Sample Output

Q. What is the geologic history of Nashville, TN? A. Let me check the geological data for Nashville's location. View Result from find-units from macrostrat (local)

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

Geological History of Nashville, Tennessee

Mesoproterozoic Basement (1.6-1.1 billion years ago)

Igneous basement rocks (granite and rhyolite)
Part of the ancient North American craton

Early-Middle Cambrian (518-504 million years ago)

Rome Formation: Mixed carbonate-siliciclastic sediments
Shallow marine environment
Part of the developing continental shelf

Middle-Late Cambrian (504-498 million years ago)

Conasauga Formation: Limestone and mixed sediments
Continued marine deposition
Alternating limestone and shale indicating fluctuating sea levels

Late Cambrian-Early Ordovician (498-470 million years ago)

Knox Dolomite: Massive dolomite sequence
Extensive shallow marine platform
Up to 1,200 meters thick
Represents long period of stable marine conditions

Middle-Late Ordovician (470-443 million years ago) Several important formations:

Stones River Group (including Murfreesboro, Pierce, Lebanon Limestones)
Nashville Group (including Hermitage, Bigby-Cannon, Catheys Formations)
Primarily limestone deposits
Rich in fossils
Shallow marine environment
Multiple cycles of sea level change

Early-Middle Silurian (443-423 million years ago)

Brassfield through Decatur Formations
Continued marine limestone deposition
Various marine environments from shallow to deeper water

Middle Devonian-Early Mississippian (390-357 million years ago)

Pegram Formation through Chattanooga Shale
Shift to more clastic (shale) deposition
Chattanooga Shale represents deeper, oxygen-poor conditions

Early-Late Mississippian (357-331 million years ago) Several limestone formations:

Fort Payne Formation
Warsaw Limestone
St. Louis Limestone
Monteagle Limestone
Hartselle Formation
Return to carbonate platform conditions
Diverse marine environments

Cenozoic to Present

Long period of erosion and exposure
Development of the current landscape
Formation of the Nashville Dome structure
River and stream deposits

Key Features

The area was predominantly a marine environment for most of its geological history
Dominated by limestone formations indicating warm, shallow seas
Multiple cycles of sea level change
Rich fossil record, especially in Ordovician rocks
Part of the Nashville Dome structural feature
Long periods of erosion have removed younger rocks
Current topography shaped by differential erosion of various limestone units

Present Day Bedrock

The bedrock of Nashville today consists primarily of Ordovician limestone formations exposed at the surface, particularly the Stones River and Nashville Group limestones. These rocks are well exposed in many areas and have influenced the development of local karst topography, including caves and sinkholes that are common in the region.

Installation

Installing via

To install Macrostrat API Server for Claude Desktop automatically via :

npx -y @/cli install @blake365/macrostrat-mcp --client claude

Extra Steps

If you want to make changes to the server you can do so by editing the src/index.ts file.

Run npm install to install dependencies
Run npm run build to build the server
Quit and restart Claude Desktop after making changes

Connecting with Claude Desktop

Open your Claude Desktop configuration at:

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

Add the server configuration:

 "mcpServers": {
 "macrostrat": {
 "command": "node",
 "args": [
 "/Full/Route/to/Folder/macrostrat/build/index.js"

Close/Quit then restart Claude Desktop Once you restart you should see a small hammer icon in the lower right corner of the textbox. If you hover over the icon you'll see the number of MCP tools available.

Troubleshooting

If you get errors when running the server you may need to provide the full path to the node command. For example, on macOS: /usr/local/bin/node

How to Use

To use the macrostrat-mcp, follow these steps:

Visit https://github.com/blake365/macrostrat-mcphttps://github.com/blake3...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using macrostrat-mcp capabilities within your Claude conversations

Additional Information

Created

December 28, 2024

Company

blake365

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More