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. 提交拉取请求