Programcomputer NASA MCP Server

🚀 NASA MCP Server Usage Guide

This guide provides a comprehensive overview of how to install, configure, and use the NASA MCP server, along with details on its features, security measures, and contribution guidelines.

🚀 Quick Start

Cloning the Repository

# Clone the repository
git clone https://github.com/ProgramComputer/NASA-MCP-server.git

Installing Dependencies

# Install project dependencies
npm install

Configuring Environment Variables

# Copy the example environment file and make modifications
cp .env.example .env

Starting the Development Server

# Start the server in development mode
npm run dev

# Build and start in production mode
npm start

✨ Features

Logging System

• Log Levels: Includes informational, warning, and error logs.
• Log Path: Stored in the logs/ directory, with file output enabled by default.
• Log Format:

  [INFO] Server initialized successfully
  [WARNING] Rate limit has reached the threshold (80%)
  [ERROR] Parameter error: 'date' must be in YYYY-MM-DD format
  

Security Precautions

• Input Validation: Uses Zod schemas for data validation.
• Prevent Code Execution: Prohibits arbitrary code execution.
• Command Injection Protection: Takes measures to prevent command injection attacks.
• Error Handling: Avoids exposing sensitive information.
• Rate Limiting: Implements rate limiting for API requests.

💻 Usage Examples

Client Calls

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { HttpClientTransport } from "@modelcontextprotocol/sdk/client/http.js";

const transport = new HttpClientTransport({
  url: "http://localhost:3000",
});

const client = new Client({
  name: "mcp-client",
  version: "1.0.0",
});

await client.connect(transport);

// Example: Get today's Astronomy Picture of the Day
const apodResult = await client.request({
  method: "nasa/apod", 
  params: {}
});

// Example: Get Mars rover photos
const marsRoverResult = await client.request({
  method: "nasa/mars-rover",
  params: { rover: "curiosity", sol: 1000 }
});

// Example: Query near-Earth objects
const neoResults = await client.request({
  method: "nasa/neo",
  params: {
    start_date: '2023-01-01',
    end_date: '2023-01-07'
  }
});

// Example: Get satellite imagery
const satelliteImage = await client.request({
  method: "nasa/gibs",
  params: {
    layer: 'MODIS_Terra_CorrectedReflectance_TrueColor',
    date: '2023-01-01'
  }
});

// Example: Use the POWER API
const powerData = await client.request({
  method: "nasa/power",
  params: {
    latitude: 34.0522,
    longitude: -118.2437,
    start_date: '2023-01-01',
    end_date: '2023-12-31'
  }
});

📦 Development and Testing

Building the Project

# Build in development mode
npm run build

# Build in production mode
npm run build -- --env production

Testing Commands

# Run unit tests
npm test

# Coverage testing
npm run test:coverage

📚 Documentation

• Project Documentation: Details the server's installation, configuration, and usage.
• API Documentation: Provides interface definitions and usage examples for all available APIs.
• Logging: File output is enabled by default, and custom log formats are supported.

🔒 Security Precautions

Secret Management

• Environment Variables: It is recommended to store sensitive information in environment variables, e.g.,

  REACT_APP_API_KEY=your_api_key_here
  

Access Control

• IP Whitelisting: Allowed IP addresses can be configured in config.json.
• Authentication: Supports OAuth and API key authentication methods.

📁 Project Structure

.
├── src/           # Source code directory
│   ├── server.js    # Main server file
│   └── routes/      # Route definitions
├── public/         # Public resources directory
│   └── config.json  # Configuration file
└── logs/          # Log output directory

📄 License

• MIT License: This project follows the MIT open-source license, allowing free use and modification.

🤝 Contribution Guidelines

1. Fork the repository
2. Create a feature branch
3. Commit your code
4. Submit a Pull Request

📞 Contact Information

• Email: support@nasa.gov
• Community Forum: NASA MCP Forum

The above is a detailed usage guide for the NASA MCP server. If you have any questions, please feel free to contact the support team.