Версия НПМ

MCP-сервер НАСА

Сервер Model Context Protocol (MCP) для API NASA, предоставляющий стандартизированный интерфейс для взаимодействия моделей ИИ с обширным массивом источников данных NASA. Этот сервер реализует официальную спецификацию Model Context Protocol.

Большое спасибо сообществу MCP за поддержку и руководство!

Функции

Доступ к более чем 20 источникам данных NASA через единый, согласованный интерфейс
Стандартизированные форматы данных, оптимизированные для использования ИИ
Автоматическая проверка параметров и обработка ошибок
Управление ограничением скорости для ключей API NASA
Подробная документация и примеры
Поддержка различных форматов изображений NASA
Преобразование и форматирование данных для совместимости с LLM
Кроссплатформенная поддержка (Windows, macOS, Linux)

Related MCP server: MCP Server For Local

Отказ от ответственности

Этот проект не связан, не одобрен и не связан с NASA (Национальное управление по аэронавтике и исследованию космического пространства) или любой из его дочерних компаний или филиалов. Это независимая реализация, которая получает доступ к общедоступным API NASA. Все используемые данные NASA являются общедоступными и подчиняются политике использования данных NASA.

Установка

Работает с npx

env NASA_API_KEY=YOUR_API_KEY npx -y @programcomputer/nasa-mcp-server@latest

Вы также можете передать ключ API в качестве аргумента командной строки:

npx -y @programcomputer/nasa-mcp-server@latest --nasa-api-key=YOUR_API_KEY

Использование SuperGateway для событий, отправленных сервером (SSE)

Вы можете использовать SuperGateway для событий, отправленных сервером (SSE).

Разработчики NASA-MCP-server НЕ ОДОБРЯЮТ репозиторий SuperGateway. Данная информация предоставляется для тех, кто хочет реализовать функционал SSE по своему усмотрению.

Ручная установка

# Clone the repository git clone https://github.com/ProgramComputer/NASA-MCP-server.git # Install dependencies cd NASA-MCP-server npm install # Run with your API key NASA_API_KEY=YOUR_API_KEY npm start

Работает на курсоре

Настройка курсора 🖥️ Примечание: требуется версия курсора 0.45.6+

Чтобы настроить сервер NASA MCP в Cursor:

Создайте или отредактируйте файл mcp.json в каталоге конфигурации курсора со следующим содержимым:

{ "mcpServers": { "nasa-mcp": { "command": "npx", "args": ["-y", "@programcomputer/nasa-mcp-server@latest"], "env": { "NASA_API_KEY": "your-api-key" } } } }

Замените your-api-key на ваш ключ API NASA с https://api.nasa.gov/ .

После добавления конфигурации перезапустите Cursor, чтобы увидеть новые инструменты NASA. Composer Agent будет автоматически использовать NASA MCP, когда это уместно для запросов, связанных с космосом.

Переменные среды

Сервер можно настроить с помощью следующих переменных среды:

Переменная	Описание
`NASA_API_KEY`	Ваш ключ API NASA (получить на api.nasa.gov)

Включены API NASA

Этот сервер MCP интегрирует следующие API NASA:

Открытый API НАСА (api.nasa.gov):
- APOD (Астрономическая картинка дня)
- EPIC (камера полихроматической съемки Земли)
- DONKI (База данных космической погоды с уведомлениями, знаниями и информацией)
- Insight (Марсианская метеорологическая служба)
- Фотографии марсохода
- NEO (веб-сервис околоземных объектов)
- EONET (система отслеживания природных событий Обсерватории Земли)
- TLE (двухстрочный элемент)
- Библиотека изображений и видео NASA
- Архив экзопланет
- API звуков NASA (бета)
- POWER (Прогноз мировых энергетических ресурсов)
API динамики солнечной системы JPL (ssd-api.jpl.nasa.gov):
- SBDB (База данных малых тел)
- Данные SBDB о близком сближении
- Данные огненного шара
- API-интерфейс разведчика
API данных о Земле :
- GIBS (Глобальные службы просмотра изображений)
- CMR (Общий репозиторий метаданных) — улучшенные возможности расширенного поиска
- EPIC (камера полихроматической съемки Земли)
- FIRMS (Информация о пожаре для системы управления ресурсами)

Методы API

Каждый API NASA предоставляется посредством стандартизированных методов MCP:

APOD (Астрономическая картинка дня)

{ "method": "nasa/apod", "params": { "date": "2023-01-01", // Optional: YYYY-MM-DD format "count": 5, // Optional: Return a specified number of random images "thumbs": true // Optional: Return URL of video thumbnail } }

Фотографии марсохода

{ "method": "nasa/mars-rover", "params": { "rover": "curiosity", // Required: "curiosity", "opportunity", or "spirit" "sol": 1000, // Either sol or earth_date is required "earth_date": "2023-01-01", // YYYY-MM-DD format "camera": "FHAZ" // Optional: Filter by camera type } }

Объекты, сближающиеся с Землей

{ "method": "nasa/neo", "params": { "start_date": "2023-01-01", // Required: YYYY-MM-DD format "end_date": "2023-01-07" // Required: YYYY-MM-DD format (max 7 days from start) } }

GIBS (Глобальные службы просмотра изображений)

{ "method": "nasa/gibs", "params": { "layer": "MODIS_Terra_CorrectedReflectance_TrueColor", // Required: Layer ID "date": "2023-01-01", // Required: YYYY-MM-DD format "format": "png" // Optional: "png" or "jpg" } }

POWER (Прогноз мировых энергетических ресурсов)

{ "method": "nasa/power", "params": { "parameters": "T2M,PRECTOTCORR,WS10M", // Required: Comma-separated list "community": "re", // Required: Community identifier "latitude": 40.7128, // Required: Latitude "longitude": -74.0060, // Required: Longitude "start": "20220101", // Required: Start date (YYYYMMDD) "end": "20220107" // Required: End date (YYYYMMDD) } }

Полную документацию по всем доступным методам и параметрам см. в справочнике API в каталоге /docs .

Система регистрации

Сервер включает в себя комплексное ведение журнала:

Статус и ход операции
Показатели производительности
Отслеживание лимита скорости
Ошибочные состояния
Запросить проверку

Примеры сообщений журнала:

[INFO] NASA MCP Server initialized successfully [INFO] Processing APOD request for date: 2023-01-01 [INFO] Fetching Mars Rover data for Curiosity, sol 1000 [WARNING] Rate limit threshold reached (80%) [ERROR] Invalid parameter: 'date' must be in YYYY-MM-DD format

Соображения безопасности

Этот сервер MCP реализует лучшие практики безопасности в соответствии со спецификациями Model Context Protocol:

Проверка и очистка входных данных с использованием схем Zod
Не допускается выполнение произвольного кода.
Защита от инъекции команд
Правильная обработка ошибок для предотвращения утечки информации
Ограничение скорости и контроль тайм-аута для запросов API
Нет постоянного состояния, которое можно было бы использовать между сеансами

Разработка

# Clone the repository git clone https://github.com/ProgramComputer/NASA-MCP-server.git # Install dependencies npm install # Copy the example environment file and update with your API keys cp .env.example .env # Build the TypeScript code npm run build # Start the development server npm run dev # Run tests npm test

Тестирование с помощью MCP Inspector

В состав сервера NASA MCP входит скрипт, который поможет вам протестировать API с помощью MCP Inspector:

# Run the provided test script ./scripts/test-with-inspector.sh

Это позволит:

Создайте проект, чтобы убедиться, что в него включены последние изменения.
Запустите MCP Inspector с запущенным сервером NASA MCP
Позволяет интерактивно тестировать все API NASA.

Примеры тестовых запросов

Репозиторий содержит примеры тестовых запросов для каждого API, которые можно скопировать и вставить в MCP Inspector:

# View the example test requests cat docs/inspector-test-examples.md

Подробные примеры см. в документе «Примеры тестов инспектора» .

Использование клиента MCP

Этот сервер следует официальному протоколу Model Context Protocol. Вот пример того, как использовать его с MCP SDK:

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: Search for 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 from GIBS const satelliteImage = await client.request({ method: "nasa/gibs", params: { layer: 'MODIS_Terra_CorrectedReflectance_TrueColor', date: '2023-01-01' } }); // Example: Use the new POWER API const powerData = await client.request({ method: "nasa/power", params: { parameters: "T2M,PRECTOTCORR,WS10M", community: "re", latitude: 40.7128, longitude: -74.0060, start: "20220101", end: "20220107" } });

Внося вклад

Форк репозитория
Создайте свою ветку функций
Запуск тестов: npm test
Отправить запрос на извлечение

Лицензия

Лицензия ISC — подробности см. в файле ЛИЦЕНЗИЯ

NASA MCP Server