NASA MCP Server

🚀 NASA MCP 服務器

NASA MCP 服務器是一個用於獲取 NASA 相關數據的服務，支持獲取 Astronomy Picture of the Day (APOD)、Mars Rover 照片等。它遵循安全最佳實踐，保障數據交互的安全性。

🚀 快速開始

你可以按照以下步驟完成項目的安裝與啟動：

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

# 安裝依賴項
npm install

# 複製示例環境文件並更新為你的 API 密鑰
cp .env.example .env

# 構建 TypeScript 代碼
npm run build

# 啟動開發服務器
npm start

📦 安裝指南

環境變量配置

在項目的根目錄中創建一個 .env 文件，並添加以下內容：

NEXT_PUBLIC_API_KEY=your_api_key_here
NEXT_PUBLIC_BASE_URL=http://localhost:3000

💻 使用示例

基礎用法

獲取 Astronomy Picture of the Day (APOD)

const result = await client.request({
  method: "nasa/apod",
  params: {}
});

獲取 Mars Rover 照片

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

🔧 技術細節

日誌系統

日誌示例

[INFO] NASA MCP 服務器初始化成功
[INFO] 處理 APOD 請求，日期為：2023-01-01
[WARNING] 網絡請求超時（等待時間超過預期）
[ERROR] 無效參數：'date' 必須符合 YYYY-MM-DD 格式

安全注意事項

本 MCP 服務器實現安全最佳實踐，遵循模型上下文協議規範：

• 輸入驗證和清理使用 Zod 模式
• 不執行任意代碼
• 防護命令注入攻擊
• 正確處理錯誤以防止信息洩露
• 實施速率限制和請求超時控制
• 不保留可能被跨會話利用的持久狀態

🛠️ 開發指南

開發步驟

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

# 安裝依賴項
npm install

# 複製示例環境文件並更新為你的 API 密鑰
cp .env.example .env

# 構建 TypeScript 代碼
npm run build

# 啟動開發服務器
npm run dev

# 運行測試
npm test

🤝 貢獻指南

1. 叉克倉庫
2. 創建功能分支
3. 運行測試：npm test
4. 提交拉取請求