NASA MCP サーバー
NASA API用のモデルコンテキストプロトコル（MCP）サーバー。AIモデルがNASAの膨大なデータソースと連携するための標準化されたインターフェースを提供します。このサーバーは、公式のモデルコンテキストプロトコル仕様を実装しています。
サポートと指導をいただいた MCP コミュニティに心から感謝します。
特徴
Related MCP server: MCP Server For Local
免責事項
このプロジェクトは、NASA（アメリカ航空宇宙局）またはその子会社・関連機関とは一切関係がなく、提携、承認、または関連関係もありません。NASAの公開APIにアクセスする独立した実装です。使用されている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
サーバー送信イベント (SSE) に SuperGateway を使用する
Server-Sent Events (SSE) にはSuperGatewayを使用できます。
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 以上が必要です
Cursor で NASA MCP サーバーを構成するには:
カーソル構成ディレクトリに次の内容のmcp.jsonファイルを作成または編集します。
{
"mcpServers": {
"nasa-mcp": {
"command": "npx",
"args": ["-y", "@programcomputer/nasa-mcp-server@latest"],
"env": {
"NASA_API_KEY": "your-api-key"
}
}
}
}
your-api-key https://api.nasa.gov/の NASA API キーに置き換えます。
設定を追加したら、Cursor を再起動して新しい NASA ツールを確認してください。Composer Agent は、宇宙関連のクエリに適切な場合に自動的に NASA MCP を使用します。
環境変数
サーバーは次の環境変数を使用して構成できます。
変数 | 説明 |
NASA_API_KEY
| NASA API キー (api.nasa.gov で取得) |
NASA APIが含まれています
この MCP サーバーは、次の NASA API を統合します。
NASA オープン API (api.nasa.gov):
JPL 太陽系ダイナミクス API (ssd-api.jpl.nasa.gov):
SBDB（小天体データベース）
SBDB接近データ
ファイアボールデータ
スカウトAPI
地球データAPI :
APIメソッド
各 NASA API は、標準化された 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)
}
}
利用可能なすべてのメソッドとパラメータの完全なドキュメントについては、 /docsディレクトリの API リファレンスを参照してください。
ログシステム
サーバーには包括的なログ機能が含まれています:
運用状況と進捗
パフォーマンスメトリック
レート制限の追跡
エラー条件
リクエストの検証
ログメッセージの例:
[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 サーバーは、モデル コンテキスト プロトコル仕様に従ったセキュリティのベスト プラクティスを実装します。
発達
# 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 サーバーには、MCP インスペクターを使用して API をテストするのに役立つスクリプトが含まれています。
# Run the provided test script
./scripts/test-with-inspector.sh
これにより、次のようになります。
最新の変更が確実に含まれるようにプロジェクトをビルドします
NASA MCPサーバーが稼働している状態でMCPインスペクターを起動します。
NASAのすべてのAPIをインタラクティブにテストできます
テストリクエストの例
リポジトリには、MCP インスペクターにコピーして貼り付けることができる各 API のサンプル テスト リクエストが含まれています。
# View the example test requests
cat docs/inspector-test-examples.md
詳細な例については、 「Inspector テストの例」ドキュメントを参照してください。
MCPクライアントの使用
このサーバーは公式のモデルコンテキストプロトコルに準拠しています。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 ライセンス - 詳細については LICENSE ファイルを参照してください
