seed-mcp scaffold: clone docs-mcp-template, customize for crop_seed PRODUCT_NAME
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>
This commit is contained in:
2026-05-25 12:28:49 -04:00
commit ac40e05734
35 changed files with 3833 additions and 0 deletions
+84
View File
@@ -0,0 +1,84 @@
# 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)