Kinship Earth MCP

亲情地球

人工智能代理的生态智能。

Kinship Earth是一个统一的MCP服务器，可以让人工智能查询生态数据。向克劳德询问物种、气候和生态系统，并在一个回复中获得将多个科学来源的数据组合在一起的答案。

You: What were the climate conditions at Wind River Experimental Forest
     during the 2023 breeding season?

Claude: [calls ecology_get_environmental_context]

     Wind River (NEON site WREF, 45.82°N 121.95°W, 371m elevation)
     June 12-18, 2023:
     - Temperature: 12-28°C (mean 19.4°C)
     - Precipitation: 2.1mm total (dry week)
     - Soil temperature (0-7cm): 14.2°C mean
     - Soil moisture: 0.31 m³/m³
     - Nearest NEON site: WREF (0km) — 156 data products available

没有一个API能为您提供这一点。亲属地球结合 霓虹 （81个美国生态遗址）， 奥比斯 （168M+海洋物种记录），以及 ERA5 （1940年的全球气候）形成一个连贯的界面。

______________________________________________________________________

快速入门（克劳德桌面版）

先决条件

• 克劳德桌面版 安装
• Python 3.12+和 紫外线 安装

1.克隆并安装

git clone https://github.com/christinebuilds/kinship-earth-mcp.git
cd kinship-earth-mcp
uv sync

2.添加到克劳德桌面

打开您的Claude Desktop配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

添加Kinship Earth编排服务器：

{
  "mcpServers": {
    "kinship-earth": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/FULL/PATH/TO/kinship-earth-mcp",
        "--package", "kinship-orchestrator",
        "python", "-m", "kinship_orchestrator.server"
      ]
    }
  }
}

替换 /FULL/PATH/TO/kinship-earth-mcp 使用克隆仓库的实际路径。

3.重新启动克劳德桌面

重新启动克劳德桌面。您应该在MCP服务器列表中看到“亲属地球”（单击锤子图标）。

4.试试看

问克劳德：

“俄勒冈州波特兰附近有哪些生态监测点？”

“描述可用的生态数据源”

“2023年6月15日，纬度45.5，经度-122.7的气候是什么样的？”

______________________________________________________________________

你可以问什么

跨源查询（唯一值）

这些将多个数据源组合在一个答案中：

“在马萨诸塞州伍兹霍尔附近观察到普通海豚时，环境条件如何？”

“比较2023年夏季NEON风河和哈佛森林的气候”

“普吉特海湾地区有哪些生态数据？”

物种观察（OBIS——海洋生物多样性）

“2020-2023年在北太平洋发现蓝鲸”

“大堡礁附近记录了哪些海洋物种？”

“显示科德角附近的宽吻海豚发生数据”

气候数据（ERA5--全球，1940年至今）

2024年1月，北纬47°、西经122°的温度和降水量是多少

“给我一周亚马逊雨林的每小时气候数据”

“这个地方的土壤温度和湿度状况如何？”

生态监测点（近地天体----美国81个监测点）

“太平洋西北部有哪些近地天体？”

“跟我说说风河实验林遗址”

“NEON收集哪些数据产品？”

______________________________________________________________________

可用的MCP工具

您还可以运行单个数据源服务器以实现更精细的访问：

______________________________________________________________________

运行单个服务器

如果你只需要一个数据源，你可以在Claude Desktop中运行单个服务器：

{
  "mcpServers": {
    "neon": {
      "command": "uv",
      "args": [
        "run", "--directory", "/FULL/PATH/TO/kinship-earth-mcp",
        "--package", "neonscience-mcp",
        "python", "-m", "neonscience_mcp.server"
      ]
    },
    "obis": {
      "command": "uv",
      "args": [
        "run", "--directory", "/FULL/PATH/TO/kinship-earth-mcp",
        "--package", "obis-mcp",
        "python", "-m", "obis_mcp.server"
      ]
    },
    "era5": {
      "command": "uv",
      "args": [
        "run", "--directory", "/FULL/PATH/TO/kinship-earth-mcp",
        "--package", "era5-mcp",
        "python", "-m", "era5_mcp.server"
      ]
    }
  }
}

或者从命令行使用统一启动器：

kinship-earth --list              # Show available servers
kinship-earth neonscience         # Start NEON server
kinship-earth orchestrator        # Start orchestrator (all sources)

______________________________________________________________________

数据源

所有数据都包括完整的来源：DOI、引用字符串、许可证信息和返回原始来源的链接。每条记录都是可追溯的。

______________________________________________________________________

建筑

┌─────────────────────────────────────────┐
│  AI Agent (Claude Desktop, etc.)        │
└─────────────────┬───────────────────────┘
                  │ MCP (stdio)
┌─────────────────▼───────────────────────┐
│  Orchestrator                            │
│  ecology_get_environmental_context       │
│  ecology_search                          │
│  ecology_describe_sources                │
└──┬──────────────┬───────────────┬───────┘
   │              │               │
┌──▼───┐    ┌────▼────┐    ┌────▼────┐
│ NEON │    │  OBIS   │    │  ERA5   │
│ 81   │    │ 168M    │    │ Global  │
│sites │    │ marine  │    │ climate │
│      │    │ records │    │ 1940-   │
└──────┘    └─────────┘    └─────────┘

所有数据都通过共享模式流动(EcologicalObservation)与对齐 达尔文核心标准 标准。结果包括相关性评分、质量等级和完整来源。

Monorepo结构：

kinship-earth-mcp/
  shared/           ← EcologicalObservation schema + ranking layer
  servers/
    neonscience/    ← NEON adapter + MCP server
    obis/           ← OBIS adapter + MCP server
    era5/           ← ERA5 adapter + MCP server
    orchestrator/   ← Cross-source intelligence tools
  launcher/         ← Unified CLI

______________________________________________________________________

运行测试

uv run --package kinship-orchestrator pytest servers/ -v

在所有服务器上进行了36次测试，命中了真实的API。测试验证了连接性、模式合规性、语义正确性（鲸目动物中真的有海豚吗？）和科学适应性（数据是否回答了真实的研究问题？）。

______________________________________________________________________

路线图

第一阶段（当前）——MVP： NEON+OBIS+ERA5+编曲。完成。

第2阶段——扩展： Xeno canto（鸟类音频）、eBird（1.7B鸟类观测）、SoilGrids（全球土壤）。用于数据发现的源注册表。

第三阶段——情报： PostgreSQL+pgvector用于本地缓存，知识图用于生态推理，跨模式嵌入。

______________________________________________________________________

引用

如果您在研究中使用Kinship Earth，请引用基础数据来源：

• 霓虹灯： 国家生态观测网。https://www.neonscience.org
• 奥比斯： 海洋生物多样性信息系统。https://obis.org
• ERA5： Hersbach等人（2020）。ERA5全球再分析。Q.J.R.流星。社会科学院，146（730），1999-2049。DOI： 2002年10月10日/qj.3803

______________________________________________________________________

许可证

麻省理工学院