justin
ac40e05734
Image rebuild (skip scrape) / build (push) Failing after 7s
Sibling project to crop-chem-docs, same MCP-template lineage. Corpus is
seed/hybrid varieties across 6 vendors instead of pesticide labels.
What's customized vs. the template:
- CLAUDE.md: vendor matrix, build priority, Pioneer fallback policy,
canonical sidecar schema (per-crop), Golden Harvest disease-scale
reversal gotcha, no-IPv6 / HTTPS-clone note
- README.md: vendor coverage table, tool list, phase status
- Dockerfile: PRODUCT_NAME=crop_seed default, sources.json (not
bundles.json), HYBRID_SEARCH=true, OLLAMA_URL + RERANK_URL Docker
DNS defaults (same llama-rerank sidecar as crop-chem-docs)
- .gitea/workflows/refresh.yml: monthly cron (seed catalogs move
slowly), 5 GREEN scraper steps, corpus-YYYY.MM.DD tag for Drawbar
pinning, continue-on-error on GC step
- .gitea/workflows/image-only.yml: paths filter + cancel-in-progress
concurrency group
- scripts/registry_gc.py: lifted from crop-chem-docs (correct Gitea
packages API URL + UA header to bypass CF block on default
Python-urllib UA)
- sources.json: catalog of 6 sources + scope_filter + per-source
schema notes + Pioneer-exclusion rationale
- scrape/runner.py: dispatcher with --all = GREEN-only
- scrape/sources/{bayer_seeds,golden_harvest,nk,agripro,becks_pfr,
becks_products}.py: stub modules with implementation notes
- docs_mcp/server.py: PRODUCT_NAME default → crop_seed,
PRODUCT_DOCS_URL → repo URL
Pioneer is intentionally NOT a source. ToS bans automation; dealer
locator is login-gated. The MCP returns a curated fallback lesson
directing the user to pioneer.com.
Next phases:
- Phase 1: implement bayer_seeds (lift-and-shift from crop-chem-docs
Bayer scraper; same __NEXT_DATA__ infra)
- Phase 7: curate eval/queries.jsonl
- Phase 11: lessons.md with Pioneer fallback + disease-scale notes
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
85 lines
3.3 KiB
Markdown
85 lines
3.3 KiB
Markdown
# seed-mcp
|
|
|
|
MCP server over the public catalogs of major US row-crop seed
|
|
vendors — corn, soybeans, wheat. Sibling project to
|
|
[`crop-chem-docs`](https://git.jpaul.io/justin/crop-chem-docs)
|
|
(pesticide labels), feeding the same Drawbar farm-advisor AI.
|
|
|
|
The server exposes per-variety records with **agronomic ratings**,
|
|
**disease tolerance**, **trait stack**, **maturity**, and
|
|
**regional notes** — so the advisor can answer questions like
|
|
"which corn hybrid for sandy soil, drought-prone, RM ≤105 in
|
|
northeast Iowa?" without rummaging through individual brand sites.
|
|
|
|
## Vendor coverage
|
|
|
|
| Vendor | Verdict | Varieties | Notes |
|
|
|---|---|---|---|
|
|
| Bayer seeds (DEKALB + Asgrow + WestBred) | 🟢 | ~475 | Same `cropscience.bayer.us` Next.js infra as crop-chem-docs |
|
|
| Golden Harvest (Syngenta) | 🟢 | ~175 | Sitemap + server-rendered HTML + Syngenta CDN PDFs |
|
|
| NK (Syngenta) | 🟢 | 29 | Shares PDF fetcher with Golden Harvest |
|
|
| AgriPro (Syngenta wheat) | 🟢 | 24 | Drupal Views, server-rendered |
|
|
| Beck's PFR | 🟡 | 2,089 | Public Sanity GROQ API (no auth) |
|
|
| Beck's products | 🟡 | 860 | Identity-only until SeedIQ XHR sniffed |
|
|
| Pioneer (Corteva) | 🔴 | — | ToS bans automation — curated fallback lesson instead |
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
git clone https://git.jpaul.io/justin/seed-mcp.git
|
|
cd seed-mcp
|
|
python -m venv venv && source venv/bin/activate
|
|
pip install -r requirements.txt
|
|
|
|
# Run one scraper
|
|
python -m scrape.runner --source bayer_seeds --force
|
|
|
|
# Rebuild indexes
|
|
python -m rag.index --rebuild
|
|
|
|
# Local MCP server (stdio for Claude Desktop dev)
|
|
python -m docs_mcp.server --transport stdio
|
|
```
|
|
|
|
## Tools exposed
|
|
|
|
| Tool | Purpose |
|
|
|---|---|
|
|
| `search_docs` | Hybrid + rerank variety search with crop / RM / trait / region filters |
|
|
| `get_page` | Full variety record by `(source, source_key)` |
|
|
| `list_versions` | Discover crops, brands, traits, RM/MG ranges, wheat classes |
|
|
| `corpus_status` | Counts + freshness; useful for health probes |
|
|
| `crop_seed_api_lessons` | Curated agronomy lessons — Pioneer fallback, disease-scale normalization, regional placement heuristics |
|
|
|
|
## Build phases
|
|
|
|
This is a clone of [`docs-mcp-template`](https://git.jpaul.io/justin/docs-mcp-template).
|
|
The 13 phases in `PLAN.md` apply:
|
|
|
|
| Phase | Status |
|
|
|---|---|
|
|
| 0 — scaffold | done |
|
|
| 1 — first scraper (bayer_seeds) | next |
|
|
| 2 — chunk + index | pending |
|
|
| 3 — baseline MCP tools | template defaults |
|
|
| 4-5 — Dockerfile + CI | done (placeholders filled) |
|
|
| 6 — reranker | shares `llama-rerank` sidecar with crop-chem-docs |
|
|
| 7 — eval harness | pending (curate ~25 queries) |
|
|
| 8 — hybrid search | done (template) |
|
|
| 9 — diff_versions, list_cluster | optional |
|
|
| 11 — `crop_seed_api_lessons` curated layer | pending |
|
|
|
|
See `CLAUDE.md` for the canonical sidecar schema and the
|
|
disease-scale-normalization gotcha (Golden Harvest is reversed).
|
|
|
|
## Infrastructure
|
|
|
|
- **Registry**: `git.jpaul.io/justin/seed-mcp:latest` (Watchtower) /
|
|
`:corpus-YYYY.MM.DD` (production pin)
|
|
- **Embedder**: shared Ollama pool with crop-chem-docs (Gitea-host
|
|
GPUs + Windows Ollama; CI never hits trashpanda's production Ollama)
|
|
- **Reranker**: shared `llama-rerank` sidecar on trashpanda's Tesla
|
|
P4 (one container, both MCPs use it)
|
|
- **PRODUCT_NAME**: `crop_seed` (not `seed_mcp` — used in Chroma
|
|
collection, BM25 db filename, and `crop_seed_api_lessons` tool)
|