Programcomputer NASA MCP Server

🚀 NASA MCP 服務器使用指南

本指南詳細介紹了 NASA MCP 服務器的安裝、配置、功能使用等內容，幫助你快速上手並安全使用該服務器。

🚀 快速開始

克隆倉庫

# 克隆倉庫
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 請求實施限流控制。

📦 安裝指南

克隆倉庫

# 克隆倉庫
git clone https://github.com/ProgramComputer/NASA-MCP-server.git

安裝依賴

# 安裝項目依賴
npm install

配置環境變量

# 複製示例環境文件並進行修改
cp .env.example .env

啟動開發服務器

# 開發模式啟動服務器
npm run dev

# 生產模式構建並啟動
npm start

💻 使用示例

基礎用法

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'
  }
});

📚 詳細文檔

• 項目文檔：詳細說明了服務器的安裝、配置和使用方法。
• API 文檔：提供了所有可用 API 的接口定義和使用示例。
• 日誌記錄：默認啟用文件輸出，支持自定義日誌格式。

🔧 技術細節

開發與測試

構建項目

# 在開發模式下構建
npm run build

# 在生產模式下構建
npm run build -- --env production

測試命令

# 運行單元測試
npm test

# 覆蓋率測試
npm run test:coverage

安全注意事項

密鑰管理

• 環境變量：建議將敏感信息存儲在環境變量中，如：

  REACT_APP_API_KEY=your_api_key_here
  

訪問控制

• IP 白名單：可以在 config.json 中配置允許訪問的 IP 地址。
• 身份驗證：支持 OAuth 和 API 密鑰認證方式。

項目結構

.
├── src/           # 源代碼目錄
│   ├── server.js    # 主服務器文件
│   └── routes/      # 路由定義
├── public/         # 公共資源目錄
│   └── config.json  # 配置文件
└── logs/          # 日誌輸出目錄

📄 許可證

• MIT License：項目遵循 MIT 開源協議，允許自由使用和修改。

👥 貢獻指南

1. fork 倉庫
2. 創建功能分支
3. 提交代碼
4. 提交 Pull Request

📞 聯繫方式

• 郵件：support@nasa.gov
• 社區論壇：NASA MCP 論壇

以上為 NASA MCP 服務器的詳細使用指南，如有任何問題，請隨時聯繫支持團隊。