plant-intel

정원 계획을 위해 코딩 에이전트에게 구조화된 식물 데이터를 제공하는 MCP 서버입니다: 종별 관리 프로필, 스스로 설명하는 동반 식물 검사, 그리고 10년간의 관측 기상 데이터에서 도출된 서리 날짜 기반 파종 시기입니다.

companion_check("tomato", "potato")
  -> bad: both are Solanaceae. Same-family crops share soilborne diseases and
     compete for the same rotation slot, so plant them apart and rotate the bed.

왜 이걸 위한 MCP 서버인가

정원 계획에 대해 묻는 모델은 그럴듯한 식재 간격 수치와 동반 식재 조언을 기꺼이 만들어냅니다. 대부분은 민간 전승에 불과하며, 그 어느 것도 추적 가능하지 않습니다. 세 가지 이유로 이는 프롬프트가 아닌 서버로 만들 가치가 있습니다:

1. 데이터는 실제이며 출처가 명시됩니다. 모든 레코드는 데이터가 어디서 왔는지, 어떤 라이선스 하에 있는지 명시합니다.

2. 공백이 보입니다. 상위 계층이 필드를 제공하지 않으면 응답이 그렇게 명시합니다. 어떤 출처도 수치를 게시하지 않으면, 임의로 채우는 대신 설명과 함께 null로 남깁니다.

3. 판정에는 메커니즘이 담깁니다. companion_check는 정원 블로그가 그렇게 말했다는 이유로 "이 둘은 잘 어울린다"고 말하지 않습니다. 관리 데이터의 증거를 바탕으로 왜 그런지 말하며, 증거가 전혀 없을 때는 그 사실을 인정합니다.

Related MCP server: nasa-exoplanet-mcp

도구

모든 도구는 간결한 JSON을 반환합니다. HTML이나 페이지 덤프는 없습니다.

companion_check는 민간 전설이 아닌 메커니즘을 반환합니다

이 서버의 소스 목록에 있는 어떤 API도 식물 적대자를 게시하지 않습니다 — Permapeople은 "동반자" 링크만 나열합니다 — 따라서 좋음/나쁨/중립 답변을 단순히 조회할 수 없습니다. 정원 지식을 반복하는 대신, 부정적인 경우는 관리 데이터에 이미 있는 증거에서 파생됩니다:

위험 메커니즘은 긍정적 목록보다 우선하지만, 모든 일치하는 이유가 반환되며, 무시된 것도 포함되어 혼합 쌍이 명확하게 유지됩니다. neutral 판정은 그것이 호환성의 증거가 아니라 증거 부재임을 명확히 명시합니다.

planting_window는 작물 시기를 추측하지 않습니다

좌표를 주면 Open-Meteo의 10년 전체 일일 최저 기온에서 중앙값 봄 마지막 서리, 가을 첫 서리, 계절 길이, 그리고 해당 지역의 USDA 구역을 파생합니다 — 그런 다음 식물의 게시된 내한성 범위와 대조합니다. 게시된 정상값과 검증됨:

하지 않을 일은 작물 절반을 발명하는 것입니다. 이 목록의 어떤 소스도 성숙까지의 일수나 서리 내한성 등급을 게시하지 않으므로, 이식 및 파종 날짜는 days_to_maturity와 frost_tolerance를 직접 제공할 때만 나타납니다. 그 구분은 의도적입니다: 이 서버는 기후 절반을 소유하고, 호출자는 작물 절반을 소유합니다.

남반구 지역은 자체 성장 계절로 읽습니다. 달력 연도로 그룹화하면 남반구 여름이 둘로 나뉘고 서리 없는 기간이 대략 하루로 보고됩니다.

설치

Node 20 이상과 무료 Perenual API 키가 필요합니다.

npm install -g plant-intel-mcp

또는 저장소에서 직접 실행:

git clone https://github.com/wyattlindsey/plant-intel-mcp.git && cd plant-intel-mcp && npm install && npm run build

Claude Code

claude mcp add plant-intel --env PERENUAL_API_KEY=your-key -- npx -y plant-intel-mcp

Claude Desktop

claude_desktop_config.json에서:

{
  "mcpServers": {
    "plant-intel": {
      "command": "npx",
      "args": ["-y", "plant-intel-mcp"],
      "env": {
        "PERENUAL_API_KEY": "your-key"
      }
    }
  }
}

구성

Perenual 키가 없어도 서버는 중지되지 않습니다. 도구는 계속 나열되고 각 호출은 설정할 변수와 키를 얻을 수 있는 위치를 답변합니다.

출처 및 한계

이 서버가 정직하게 답변할 수 있는 것을 형성하는 제약이므로 명확히 명시합니다.

100/일 상한 때문에 서버는 적극적으로 캐시하고(종 데이터 30일, 기상 아카이브 90일) 일일 예산을 보호하며, 가지고 있지 않은 요청을 거부하고 거부할 때 재설정 시간을 명명합니다. 캐시 히트는 그에 대해 청구되지 않습니다.

plant_details는 간격을 반환하지 않습니다. 여기 어떤 소스도 게시하지 않으며, 아무도 뒷받침하지 않는 숫자보다 메모가 있는 null이 더 유용합니다.

개발

npm test          # unit and protocol tests, no network
npm run typecheck
npm run build
npm run test:live # opt-in; hits real APIs and spends quota

라이브 스위트는 드리프트 감지를 위해 존재합니다. 픽스처는 게시된 문서에서 구축되었으므로, 매퍼가 읽는 모든 필드가 여전히 상위에 존재하는지 주장합니다. Open-Meteo 테스트는 자격 증명이 필요 없으며 어디서나 실행됩니다.

아키텍처와 규칙은 CLAUDE.md를 참조하세요.

라이선스

MIT. LICENSE 참조.

이 서버를 통해 검색된 데이터는 자체 소스의 약관에 따라 유지됩니다 — 위 표 참조. 특히 Perenual의 무료 티어는 비상업적이며, Permapeople의 데이터는 share-alike입니다.