🚀 NASA MCP 服务器
NASA MCP 服务器是一个用于处理 NASA 相关数据请求的项目，能帮助用户便捷地获取诸如天文每日一图、火星探测器照片等数据，同时具备完善的日志系统和安全防护机制。
🚀 快速开始
若你想快速启动 NASA MCP 服务器，可按以下步骤操作：
# 克隆仓库
git clone https://github.com/ProgramComputer/NASA-MCP-server.git
# 安装依赖项
npm install
# 复制示例环境文件并更新为你的 API 密钥
cp .env.example .env
# 构建 TypeScript 代码
npm run build
# 启动开发服务器
npm start
📦 安装指南
安装该项目，你需要依次执行以下命令：
# 克隆仓库
git clone https://github.com/ProgramComputer/NASA-MCP-server.git
# 安装依赖项
npm install
# 复制示例环境文件并更新为你的 API 密钥
cp .env.example .env
# 构建 TypeScript 代码
npm run build
# 启动开发服务器
npm start
✨ 主要特性
- 数据获取：支持获取 Astronomy Picture of the Day (APOD) 以及 Mars Rover 照片等 NASA 相关数据。
- 日志系统：能记录服务器的各类运行信息，如初始化成功、请求处理、警告和错误信息等。
- 安全可靠：实现了一系列安全最佳实践，包括输入验证、防护命令注入攻击、速率限制等。
📚 详细文档
配置
环境变量
在项目的根目录中创建一个 .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
贡献指南
- 叉克仓库
- 创建功能分支
- 运行测试：
npm test - 提交拉取请求