Johgee Open Irrigation

オープンソースかつAIネイティブな、英国の家庭庭園向け散水アドバイスです。

v1は、既にあなたが知っている情報（庭のタイプ、土壌、日当たり、水やりの方法、最近の雨、土の状態）を、説明可能なプラン、すなわちミリメートル、リットル、実行時間に変換します。これは、蛇口やタイマー、灌漑ハードウェアを制御するものではありません。また、お住まいの地域でホースパイプ使用禁止が発令されているかどうかを確認するものでもありません。

数値レコメンデーションは、バージョン管理された決定的コアから生成されます。言語モデルがそれらの事実を説明してもよいですが、ミリメートル、リットル、実行時間、制限ステータス、バリアントID、ソースを変更してはなりません。

ステータス

パブリックデータモードは、D-01（2026-08-23）以降、動的に動作します。郵便番号からは、Met Office DataHubの無料**Global Spotフィードにアクセスでき、粗いグリッドでキャッシュされます。天気を取得できない場合、APIはmanualの自己申告にフォールバックし、ミリメートルをでっち上げることはありません。制限ステータスはunknownのままです。ホースパイプとスプリンクラーのアドバイスはv3までフェイルクローズとなり、fixture はテスト専用です。

Related MCP server: UK Weather & Travel Outfit Recommender MCP Server

現在できること

• manual_contextを指定してPOST /v1/recommendationsを呼び出します（郵便番号は不要）。

• オプションで英国の郵便番号を送信できます。天気はその場で取得され、無料枠のみが使用されます。

• MCPのツールcalculate_watering（手動、ネットワーク不要）とget_watering_advice（オプションの郵便番号、サーバーが無料日枠のキーを持っていれば天気を使用）で同じ計算を実行できます。

• ShopifyページにThemeセクションをマウントするか、ローカルデモページを開くことができます。

• 最初のUKナレッジページ（HTML、JSON、JSON-LD）を読むことができます。

要件

• Node.js 22.23.2

• Corepack経由のpnpm 11.5.2

実行環境の正確なバージョンは、.node-version と package.json に記録されています。

クイックスタート

corepack enable
pnpm install --frozen-lockfile
pnpm check
pnpm dev:api

APIは http://localhost:8787 で待ち受けます。次のコマンドを実行してください。

curl -sS http://localhost:8787/v1/recommendations \
  -H 'Content-Type: application/json' \
  -d '{
    "garden_type": "borders",
    "area_m2": 12,
    "soil_class": "loamy",
    "establishment": "established",
    "irrigation_method": "watering_can",
    "manual_context": { "recent_rainfall": "light", "soil_feel": "moist" }
  }'

レスポンスヘッダーが X-Johgee-Data-Mode: manual である必要があります。fixture ヘッダーはテスト専用です。

ローカルプランナーページ: apps/public-web/watering-plan.html（ローカルAPIを指しています）。

MCP

stdioサーバーをビルドし、Cursor / Claude Desktop にそのサーバーを向けてください。APIキーは必要ありません。

pnpm --filter @johgee/contracts build
pnpm --filter @johgee/irrigation-core build
pnpm --filter @johgee/ai-tools build

{
  "mcpServers": {
    "johgee": {
      "command": "node",
      "args": ["packages/ai-tools/dist/stdio.js"]
    }
  }
}

ツール: calculate_watering（手動の自己申告）と get_watering_advice（英国の郵便番号。天気はオンデマンドで取得、なければ自己申告にフォールバック）。無効な入力は構造化された問題を返します。ツールは数値を推測しません。

スキルドラフト: packages/ai-tools/SKILL.md

プロジェクト未経験の人でも、クリーンなクローンから約10分で MCP ツールを実行できるはずです。すなわち、インストール、上記の3つのパッケージのビルド、stdioサーバーの起動です。

アーキテクチャ

Shopify page / MCP client
        │
        ▼
  Public API (Hono)  ──  MCP stdio (@johgee/ai-tools)
        │                         │
        └────────────┬────────────┘
                     ▼
           irrigation-core
           (pure functions)

• ストアフロント: Shopifyページ + テーマセクション（extensions/watering-planner）。

• 公開API: https://api.johgeeirrig.co.uk/v1（CORS: Johgee storefront）。

• コア: @johgee/irrigation-core — ネットワーク・DB・モデルなし。

• 匿名共有リンクは30日で期限切れます。トークンはハッシュとして保存されます。

• ナレッジ: apps/public-web/knowledge、llms.txt、sitemap、robots。

正確な英国の郵便番号は、データベース、ログ、トレース、ローカルストレージ、Gitに入れてはなりません。

リポジトリマップ

apps/                     Local public-web demo
extensions/               Shopify Theme section
services/                 API
packages/                 Core, contracts, planner-ui, ai-tools, content
api/                      OpenAPI 3.1
schemas/                  JSON Schema
docs/                     Product, architecture, ADRs

貢献

CONTRIBUTING.md を参照してください。また、SECURITY.md と GOVERNANCE.md も参照してください。

ライセンス

Johgeeが所有するコードはMITライセンスでライセンスされています。第三者のデータやコンテンツにはその規約が適用され、使用または再配布する前に利用登録が必須です。

公開ソース: github.com/hongzhizuo/johgee-open-irrigation