plant-intel

MCP-сервер, который предоставляет кодирующим агентам структурированные данные о растениях для планирования сада: профили ухода за видами, проверки совместимости с объяснением причин и окна посадки по датам заморозков, рассчитанные на основе десяти лет наблюдаемых погодных данных.

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 медианный последний весенний заморозок, первый осенний заморозок, длину сезона и зону USDA для участка — затем проверит это по опубликованному диапазону морозостойкости растения. Проверено по опубликованным нормам:

Чего он не будет делать — так это выдумывать половину культуры. Ни один источник в этом списке не публикует дни до созревания или класс морозостойкости, поэтому даты пересадки и посева появляются только когда вы сами укажете days_to_maturity и frost_tolerance. Это разделение намеренное: этот сервер владеет климатической половиной, а вызывающий — культурной.

Участки в южном полушарии читаются по их собственному вегетационному сезону. Группировка по календарному году разделяет южное лето на две части и сообщает безморозное окно примерно в один день.

Установка

Требуется Node 20 или новее и бесплатный ключ API Perenual.

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.