MCP TypeScript NASA Server

A TypeScript-based MCP (Model Context Protocol) server that provides seamless integration with NASA's public APIs, enabling AI assistants to access space and astronomy data including APOD, Mars rover photos, Near-Earth Objects, space weather, and Earth imagery.

🌟 Features

• 🚀 5 NASA API Tools: APOD, Mars Rovers, NEO Feed, DONKI Space Weather, EPIC Earth Imagery

• 📚 Resources Support: Access NASA data via URI-based resources (static & dynamic)

• 💬 Prompts Templates: Pre-built prompts for education and analysis

• 📦 NPX Ready: Run instantly with npx mcp-ts-stdio-nasa

• 🔧 Type-Safe: Full TypeScript implementation with Zod validation

• 🎯 MCP Compliant: Full Model Context Protocol specification support

• ⚡ Easy Setup: Works with Claude Desktop and other MCP clients

• 🔑 API Key Support: Use your own NASA API key or the demo key

🚀 Quick Start

Run with NPX (Recommended - No Installation Required)

This command downloads and runs the latest version directly from npm.

Install Globally

Install as Dependency

🔧 Configuration

Claude Desktop Setup

Add this configuration to your Claude Desktop config file:

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

Environment Variables

Create a .env file in your project root:

🛠️ Available Tools

1. nasa_apod - Astronomy Picture of the Day

Get NASA's daily featured astronomy image with detailed explanation.

Parameters:

• date (optional): Date in YYYY-MM-DD format

Example Query:

2. nasa_mars_rover_photos - Mars Rover Photography

Fetch photos from Mars rovers including Curiosity, Opportunity, Spirit, and Perseverance.

Parameters:

• rover: Rover name (curiosity, opportunity, spirit, perseverance)

• sol (optional): Martian day

• earth_date (optional): Earth date in YYYY-MM-DD

• camera (optional): Camera type (FHAZ, RHAZ, NAVCAM, etc.)

• limit: Maximum photos to return (1-25)

Example Query:

3. nasa_neo_feed - Near Earth Objects

Track asteroids and comets passing near Earth.

Parameters:

• start_date (optional): Start date in YYYY-MM-DD

• end_date (optional): End date in YYYY-MM-DD

Example Query:

4. nasa_donki_space_weather - Space Weather Events

Monitor solar flares, coronal mass ejections, and other space weather phenomena.

Parameters:

• event_type: Event type (FLR, SEP, CME, IPS, MPC, GST, RBE)

• start_date (optional): Start date

• end_date (optional): End date

Event Types:

• FLR: Solar Flare

• SEP: Solar Energetic Particle

• CME: Coronal Mass Ejection

• IPS: Interplanetary Shock

• MPC: Magnetopause Crossing

• GST: Geomagnetic Storm

• RBE: Radiation Belt Enhancement

Example Query:

5. nasa_epic_earth_imagery - Earth Polychromatic Imaging

Get full-disc Earth images from the DSCOVR satellite.

Parameters:

• image_type: natural or enhanced

• date (optional): Date in YYYY-MM-DD

• limit: Maximum images (1-20)

Example Query:

📚 Resources

Resources provide direct access to NASA data via URIs:

Static Resources

• nasa://config - NASA API configuration and status

• nasa://missions/current - List of current NASA missions

• nasa://neo/today - Today's Near-Earth Objects

Dynamic Resources (with URI templates)

• nasa://apod/{date} - APOD for specific date (e.g., nasa://apod/2024-01-15)

• nasa://rover/{rover}/latest - Latest photos from Mars rovers

Example Usage:

💬 Prompts

Pre-configured prompts for common NASA data queries:

1. explain-apod - Educational APOD Explanation

Parameters:

• date (optional): YYYY-MM-DD format

• audience (optional): child, student, or expert

Example:

2. space-weather-report - Space Weather Analysis

Parameters:

• days (optional): 1-7 days to analyze

• focus (optional): solar-flares, cme, geomagnetic, or all

Example:

3. asteroid-analysis - NEO Risk Assessment

Parameters:

• timeframe (optional): today, week, or month

• hazardous_only (optional): true/false

Example:

📝 Status

✅ Published and Working - The package has been successfully published to npm and tested with Claude Desktop.

• Latest Version: 0.2.0

• npm Package: mcp-ts-stdio-nasa

• Installation: Works via npx, global install, or as a dependency

💻 Development

Setup

Scripts

• npm run build - Build TypeScript to JavaScript

• npm run clean - Clean build artifacts

• npm run dev - Watch mode for development

• npm run lint - Run ESLint

• npm run format - Format with Prettier

• npm run mcp:inspect - Test with MCP Inspector

Testing with MCP Inspector

This opens the MCP Inspector for interactive testing of all tools.

📚 Project Structure

🌐 NASA API Information

This server uses NASA's public APIs. You can:

• Use DEMO_KEY for testing (limited rate)

• Get a free API key at https://api.nasa.gov/

• Most endpoints allow 1000 requests/hour with an API key

API Documentation

• NASA API Portal

• APOD API

• Mars Rover Photos API

• NEO API

• DONKI API

• EPIC API

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/AmazingFeature)

3. Commit your changes (git commit -m 'Add some AmazingFeature')

4. Push to the branch (git push origin feature/AmazingFeature)

5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• NASA for providing public APIs

• Anthropic for the MCP specification

• Model Context Protocol community

📧 Contact

Author: Jez (Jeremy Dawes)
Email: jeremy@jezweb.net
Website: www.jezweb.com.au

🔗 Links

• NPM Package

• GitHub Repository

• Issue Tracker

Made with ❤️ for the space and AI communities