Programcomputer NASA MCP Server

🚀 NASA MCP サーバー使用ガイド

このサーバーは、NASA 関連のデータ取得や操作を行うためのサーバーで、様々な API を提供し、安全な運用が可能です。

🚀 クイックスタート

クローン

# リポジトリをクローンする
git clone https://github.com/ProgramComputer/NASA-MCP-server.git

依存関係のインストール

# プロジェクトの依存関係をインストールする
npm install

環境変数の設定

# サンプル環境ファイルをコピーして変更する
cp .env.example .env

開発サーバーの起動

# 開発モードでサーバーを起動する
npm run dev

# 本番モードでビルドして起動する
npm start

✨ 主な機能

ログシステム

• ログレベル：情報、警告、エラーログを含む
• ログパス：logs/ ディレクトリに保存され、デフォルトではファイル出力が有効
• ログ形式：

  [INFO] サーバーの初期化に成功しました
  [WARNING] レート制限が閾値（80%）に達しました
  [ERROR] パラメータエラー：'date' は YYYY-MM-DD 形式に従う必要があります
  

セキュリティに関する注意事項

• 入力検証：Zod モデルを使用してデータを検証する
• コード実行の防止：任意のコードの実行を禁止する
• コマンドインジェクション対策：コマンドインジェクション攻撃を防止するための措置を講じる
• エラー処理：機密情報の漏洩を避ける
• レート制限：API リクエストにレート制限を適用する

💻 使用例

基本的な使用法

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

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

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

await 客户端.connect(运输);

// 例：今日の天文学画像を取得する
const apodResult = await 客户端.request({
  method: "nasa/apod", 
  params: {}
});

// 例：火星探査車の写真を取得する
const marsRoverResult = await 客户端.request({
  method: "nasa/mars-rover",
  params: { rover: "curiosity", sol: 1000 }
});

// 例：近地天体を検索する
const neoResults = await 客户端.request({
  method: "nasa/neo",
  params: {
    start_date: '2023-01-01',
    end_date: '2023-01-07'
  }
});

// 例：衛星画像を取得する
const satelliteImage = await 客户端.request({
  method: "nasa/gibs",
  params: {
    layer: 'MODIS_Terra_CorrectedReflectance_TrueColor',
    date: '2023-01-01'
  }
});

// 例：POWER API を使用する
const powerData = await 客户端.request({
  method: "nasa/power",
  params: {
    latitude: 34.0522,
    longitude: -118.2437,
    start_date: '2023-01-01',
    end_date: '2023-12-31'
  }
});

📦 インストール

開発モードでのビルド

npm run build

本番モードでのビルド

npm run build -- --env production

テストコマンド

# 単体テストを実行する
npm test

# カバレッジテストを実行する
npm run test:coverage

📚 ドキュメント

• プロジェクトドキュメント：サーバーのインストール、設定、使用方法を詳細に説明しています。
• API ドキュメント：利用可能なすべての API のインターフェース定義と使用例を提供しています。
• ログ記録：デフォルトではファイル出力が有効で、カスタムログ形式をサポートしています。

🔧 技術詳細

秘密鍵の管理

• 環境変数：機密情報を環境変数に保存することをお勧めします。例：

  REACT_APP_API_KEY=your_api_key_here
  

アクセス制御

• IP ホワイトリスト：config.json でアクセスを許可する IP アドレスを設定できます。
• 認証：OAuth と API キー認証方式をサポートしています。

プロジェクト構造

.
├── src/           # ソースコードディレクトリ
│   ├── server.js    # メインサーバーファイル
│   └── routes/      # ルート定義
├── public/         # パブリックリソースディレクトリ
│   └── config.json  # 設定ファイル
└── logs/          # ログ出力ディレクトリ

📄 ライセンス

• MIT ライセンス：このプロジェクトは MIT オープンソースライセンスに準拠しており、自由に使用および変更することができます。

貢献ガイド

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. コードをコミットする
4. Pull Request を送信する

連絡先

• メール：support@nasa.gov
• コミュニティフォーラム：NASA MCP フォーラム

以上が NASA MCP サーバーの詳細な使用ガイドです。何か質問があれば、サポートチームにお問い合わせください。