# MCP TypeScript NASA Server
[](https://www.npmjs.com/package/mcp-ts-stdio-nasa)
[](https://www.npmjs.com/package/mcp-ts-stdio-nasa)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://github.com/jezweb/mcp-ts-stdio-nasa)
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)
```bash
npx mcp-ts-stdio-nasa
```
This command downloads and runs the latest version directly from npm.
### Install Globally
```bash
npm install -g mcp-ts-stdio-nasa
mcp-ts-stdio-nasa
```
### Install as Dependency
```bash
npm install mcp-ts-stdio-nasa
```
## š§ 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`
```json
{
"mcpServers": {
"nasa": {
"command": "npx",
"args": ["mcp-ts-stdio-nasa"],
"env": {
"NASA_API_KEY": "your_api_key_here"
}
}
}
}
```
### Environment Variables
Create a `.env` file in your project root:
```env
# NASA API Configuration
NASA_API_KEY=your_api_key_here # Get from https://api.nasa.gov/
# Use "DEMO_KEY" for testing with rate limits
# Optional
DEBUG=false # Enable debug logging
```
## š ļø 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:**
```
"Show me NASA's astronomy picture from January 1, 2024"
```
### 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:**
```
"Get recent photos from Perseverance rover's navigation camera"
```
### 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:**
```
"Show me potentially hazardous asteroids passing Earth this week"
```
### 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:**
```
"Check for solar flares in the last week"
```
### 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:**
```
"Show me recent full Earth images from space"
```
## š 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:**
```
"Read the resource nasa://apod/2024-12-25"
"Show me nasa://rover/perseverance/latest"
```
## š¬ 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:**
```
"Use the explain-apod prompt for today with audience set to child"
```
### 2. `space-weather-report` - Space Weather Analysis
**Parameters:**
- `days` (optional): 1-7 days to analyze
- `focus` (optional): solar-flares, cme, geomagnetic, or all
**Example:**
```
"Generate a space-weather-report for the last 3 days focusing on solar flares"
```
### 3. `asteroid-analysis` - NEO Risk Assessment
**Parameters:**
- `timeframe` (optional): today, week, or month
- `hazardous_only` (optional): true/false
**Example:**
```
"Run asteroid-analysis for this week with hazardous_only true"
```
## š 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](https://www.npmjs.com/package/mcp-ts-stdio-nasa)
- **Installation**: Works via npx, global install, or as a dependency
## š» Development
### Setup
```bash
# Clone the repository
git clone https://github.com/jezweb/mcp-ts-stdio-nasa.git
cd mcp-ts-stdio-nasa
# Install dependencies
npm install
# Build the project
npm run build
# Run in development mode
npm run dev
```
### 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
```bash
npm run build
npm run mcp:inspect
```
This opens the MCP Inspector for interactive testing of all tools.
## š Project Structure
```
mcp-ts-stdio-nasa/
āāā src/
ā āāā index.ts # Main server entry point
ā āāā tools/ # NASA API tool implementations
ā ā āāā apod.tool.ts
ā ā āāā mars-rover.tool.ts
ā ā āāā neo.tool.ts
ā ā āāā donki.tool.ts
ā ā āāā epic.tool.ts
ā āāā services/ # NASA API service layer
ā ā āāā nasa.service.ts
ā āāā types/ # TypeScript type definitions
ā ā āāā nasa.ts
ā āāā utils/ # Utility functions
ā āāā config.ts
ā āāā logger.ts
āāā dist/ # Compiled JavaScript
āāā docs/ # Documentation
āāā package.json
āāā tsconfig.json
```
## š 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/](https://api.nasa.gov/)
- Most endpoints allow 1000 requests/hour with an API key
### API Documentation
- [NASA API Portal](https://api.nasa.gov/)
- [APOD API](https://github.com/nasa/apod-api)
- [Mars Rover Photos API](https://github.com/chrisccerami/mars-photo-api)
- [NEO API](https://api.nasa.gov/#NeoWS)
- [DONKI API](https://api.nasa.gov/#DONKI)
- [EPIC API](https://api.nasa.gov/#EPIC)
## š¤ 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](LICENSE) file for details.
## š Acknowledgments
- [NASA](https://www.nasa.gov/) for providing public APIs
- [Anthropic](https://anthropic.com/) for the MCP specification
- [Model Context Protocol](https://modelcontextprotocol.io/) community
## š§ Contact
**Author**: Jez (Jeremy Dawes)
**Email**: jeremy@jezweb.net
**Website**: [www.jezweb.com.au](https://www.jezweb.com.au)
## š Links
- [NPM Package](https://www.npmjs.com/package/mcp-ts-stdio-nasa)
- [GitHub Repository](https://github.com/jezweb/mcp-ts-stdio-nasa)
- [Issue Tracker](https://github.com/jezweb/mcp-ts-stdio-nasa/issues)
---
Made with ā¤ļø for the space and AI communities
