Axion Planetary MCP

🌍 Axion行星MCP

*地理空间人工智能代理民主化基金会*

🚀 V2.0-现在由AWS提供支持

主要更新： Axion Planetary MCP已在AWS基础设施上完全重建，以获得更好的性能、可靠性和全球可访问性。无需再设置Google Cloud！

______________________________________________________________________


*点击上图观看演示视频*

🚀 让地球观测变得像对话一样简单

从博士级别的复杂性到自然语言查询，一次安装即可完成

*“让我看看爱荷华州的作物健康状况”* • *“分析加利福尼亚州的植被”* • *“追踪太浩湖的水位”*

______________________________________________________________________

⚡ 托管版本（2分钟安装！）

立即开始使用卫星图像分析，无需任何服务器设置！

🚀 快速开始

步骤1：获取API密钥

现在用这个启动密钥试试：

axion_6C1D_634DDAEAA324235F

需要自己的钥匙吗？ 电子邮件 dhenenjay.2001@gmail.com 或 打开一个问题

步骤2：配置Claude桌面

打开您的Claude Desktop配置文件：

添加以下内容（替换 YOUR_API_KEY):

{
  "mcpServers": {
    "axion": {
      "command": "npx",
      "args": ["-y", "axion-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

步骤3：重新启动克劳德桌面

完成！问克劳德：

*“给我看纽约中央公园的NDVI植被图”*

______________________________________________________________________

💻 替代安装方法

使用环境变量

{
  "mcpServers": {
    "axion": {
      "command": "npx",
      "args": ["-y", "axion-mcp"],
      "env": {
        "AXION_API_KEY": "your_key_here"
      }
    }
  }
}

全局安装（如果npx不起作用）

npm install -g axion-mcp

{
  "mcpServers": {
    "axion": {
      "command": "axion-mcp",
      "args": ["--api-key", "YOUR_API_KEY"]
    }
  }
}

直接使用sse-bridge.mjs

{
  "mcpServers": {
    "axion": {
      "command": "node",
      "args": ["C:/path/to/sse-bridge.mjs", "https://axion-mcp-sse.onrender.com/sse", "YOUR_API_KEY"]
    }
  }
}

______________________________________________________________________

✨ 为什么要使用托管版本？

• 🚀 2分钟设置 -只需添加配置并重新启动
• ☁️ 无服务器管理 -一切都在云端运行
• 🔒 简单API密钥身份验证 -安全且简单
• ⚡ 始终保持最新状态 -最新功能自动
• 🌍 免费卫星数据 -访问Sentinel-2、Landsat、NAIP
• 💻 零维护 -无需管理流程
• 🌐 适用于任何地方 -无防火墙问题，无需打开端口

📦 托管服务器详细信息

• NPM包: axion mcp
• 服务器URL: https://axion-mcp-sse.onrender.com
• 健康检查: https://axion-mcp-sse.onrender.com/health
• 7个强大的工具 用于卫星图像分析

🌟 托管版本独占： 托管版本包括 axionsar2光学 -我们的专有 Axion基金会模型 它将SAR雷达图像转换为类似光学的图像，实现了无云、日夜对地观测。这个AI驱动的工具只能通过托管服务器使用。

注： 托管服务器在Render的空闲层上运行，如果空闲，可能需要30秒才能唤醒。对于始终在线的访问，请考虑 自足执行.

______________________________________________________________________

🎯 地理空间人工智能革命

我们正在见证地球观测的“iPhone时刻”。 就像iPhone让每个人都可以使用计算一样，Axion Planetary MCP通过简单的对话可以访问PB级的卫星数据。

🔥 范式转变

之前： 构建地理空间人工智能需要博士学位、数月的设置、复杂的API和庞大的基础设施。

现在： 任何人都可以用自然语言和一个命令构建复杂的地球观测人工智能代理： npm install

Traditional Path: 1 Expert → 1 Year → 1 Specialized Tool
Our Path:        1 Person → 2 Minutes → Unlimited Possibilities

🌟 什么成为可能

👥 谁现在可以构建地理空间AI代理：

🚀 现实世界的转变

精准农业革命 🌾

Farmer: "Create an AI agent that monitors my 500-acre farm"
Result: Daily crop health reports, irrigation optimization, 
        vegetation stress detection, yield predictions

环境监测 🌊

Researcher: "Track water quality in Lake Tahoe"
Result: Water index analysis, temporal changes,
        algae bloom detection, quality reports

城市规划 🏙️

Planner: "Analyze urban heat islands in Phoenix"
Result: Surface temperature maps, vegetation coverage,
        heat mitigation recommendations

______________________________________________________________________

🛠️ 可用工具（6）

轴数据

从多个集合中搜索卫星图像：

• Sentinel-2 （10米分辨率，5天回访）
• 陆地卫星8/9 （30米分辨率，16天回访）
• NAIP （1米航拍图像，仅限美国）

轴地图

使用以下工具创建交互式地图：

• 植被指数（NDVI、EVI、SAVI）
• 水指数（NDWI、MNDWI）
• 累积指数（NDBI）
• 真/假彩色复合材料
• 自定义乐队表达式

轴过程

过程图像：

• 无云复合材料
• 时间镶嵌
• 9+光谱指数
• 乐队数学表达式

轴分类

ML土地覆盖分类：

• 随机森林分类器
• 自定义培训点
• 多级输出
• 准确性指标

axi_oxport

导出选项：

• GeoTIFF下载
• PNG缩略图
• 地图图块（XYZ）
• 云存储（S3）

轴系统

系统实用程序：

• 健康检查
• 配置信息
• 可用收藏

______________________________________________________________________

📚 查询示例

像地理空间专家一样与克劳德交谈：

🌾 农业与粮食安全

*“显示爱荷华州农田的NDVI植被健康状况”* *“为加利福尼亚中央山谷创建作物分类图”* *“本月哪些地区出现植被压力？”*

🌊 水利

*“计算米德湖的水指数”* *“给我看看内华达沙漠的水体”* *“随时间跟踪水库水位”*

🏢 城市规划

*“德克萨斯州奥斯汀的城市扩张地图”* *“展示西雅图的建成区与绿地”* *“分析丹佛的土地利用变化”*

🌲 环境监测

*“监测黄石公园的森林健康状况”* *“创建亚马逊的假彩色合成”* *“显示2020年至2024年的植被变化”*

______________________________________________________________________

🐳 自我寄宿

想运行自己的Axion MCP服务器吗？ 无需云凭据 基本功能！

先决条件

• 码头工人 （推荐）或 Node.js 18+
• 就是这样！卫星数据来自免费的公共API。

选项1:Docker（推荐）

# Clone this repository
git clone https://github.com/Dhenenjay/Axion-Planetary-MCP
cd Axion-Planetary-MCP

# Build the Docker image
docker build -t axion-mcp .

# Run without authentication (for local/personal use)
docker run -p 3000:3000 -e REQUIRE_AUTH=false axion-mcp

# OR run with authentication (for production/shared use)
docker run -p 3000:3000 \
  -e REQUIRE_AUTH=true \
  -e AXION_API_KEY=your-secret-key-here \
  axion-mcp

# Test it's working
curl http://localhost:3000/health
# Should return: {"status":"healthy","tools":6}

选项2：从源代码运行

# Clone and install
git clone https://github.com/Dhenenjay/Axion-Planetary-MCP
cd Axion-Planetary-MCP
npm install

# Build the SSE server
npm run build:sse

# Run (no auth)
REQUIRE_AUTH=false npm run start:sse

# OR with auth
REQUIRE_AUTH=true AXION_API_KEY=your-key npm run start:sse

将Claude Desktop连接到您的服务器

无身份验证：

{
  "mcpServers": {
    "axion-local": {
      "command": "node",
      "args": ["C:/path/to/Axion-Planetary-MCP/sse-bridge.mjs", "http://localhost:3000/sse"]
    }
  }
}

通过身份验证：

{
  "mcpServers": {
    "axion-local": {
      "command": "node",
      "args": ["C:/path/to/Axion-Planetary-MCP/sse-bridge.mjs", "http://localhost:3000/sse", "your-secret-key-here"]
    }
  }
}

云部署

包括 Dockerfile 适用于任何集装箱平台：

环境变量引用

没有任何证书你会得到什么

✅ 全卫星数据搜索 （Sentinel-2、Landsat、NAIP）\ ✅ 交互式地图生成 （NDVI、NDWI、假色等）\ ✅ 图像处理 （复合材料、指数、波段数学）\ ✅ ML分类 （随机森林土地覆盖）\ ✅ 系统健康与信息

什么需要AWS凭据（可选）

⚠️ GeoTIFF导出到S3 -需要AWS凭据和S3存储桶\ ⚠️ 大文件下载 -超过10MB的导出需要S3

Docker编写示例

version: '3.8'
services:
  axion:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - REQUIRE_AUTH=true
      - AXION_API_KEY=${AXION_API_KEY}  # Set in .env file
      # Optional AWS for exports:
      # - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
      # - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
    restart: unless-stopped

______________________________________________________________________

📡 数据源

所有数据通过以下方式访问 AWS地球搜索STAC API （免费，无需身份验证）。

______________________________________________________________________

🔧 故障排除

“找不到命令：npx”

从以下位置安装Node.js 18+

“未经授权-API密钥无效”

1. 验证您的API密钥是否正确
2. 确保没有多余的空间
3. 尝试使用环境变量： "env": { "AXION_API_KEY": "your_key" }

“连接被拒绝”

托管服务器可能正在休眠（空闲层）。请等待30秒，然后重试，或自行主持。

Claude没有显示Axion工具

1. 完全退出克劳德桌面
2. 检查配置JSON语法 Jsonlin.com
3. 重新启动克劳德桌面
4. 在Claude的工具列表中查找“axion”

______________________________________________________________________

🏗️ 建筑

┌─────────────────┐
│   Claude AI     │  (Your AI Assistant)
└────────┬────────┘
         │ MCP Protocol
         ▼
┌─────────────────┐
│  axion-mcp      │  (NPM Bridge Package)
└────────┬────────┘
         │ SSE/HTTP
         ▼
┌─────────────────┐
│  Axion Server   │  (Cloud or Self-hosted)
└────────┬────────┘
         │ STAC API
         ▼
┌─────────────────┐
│  AWS Earth      │  (Free Satellite Data)
│  Search         │  Sentinel-2, Landsat, NAIP
└─────────────────┘

______________________________________________________________________

🤝 贡献

欢迎投稿！请随时：

• 通过以下方式报告错误
• 提交拉取请求
• 建议新功能
• 改进文档

______________________________________________________________________

📄 许可证

麻省理工学院许可证-您可以在项目中自由使用！

______________________________________________________________________

💬 支持

• GitHub 问题: 报告错误或请求功能
• 托管服务器: axion-mcp-se.onrender.com
• NPM包: axion mcp

______________________________________________________________________

🎆 未来就是现在

这不仅仅是一个工具，它是一场革命的基础。

我们正在使地球观测民主化，使地理空间情报像发送短信一样易于获取。

🌍 你将建造什么？

🌾 监测作物的农业人工智能？ • 🌊 追踪资源的水分析？ • 🌳 应对气候变化的森林监测？

______________________________________________________________________

地球在等待。工具准备好了。唯一的问题是：你会发现什么？

*从博士级的复杂性到对话的简单性* ✨

建于❤️ 加快人类应对最大挑战的步伐