pesticide-mcp

FAMIC が公開する農薬登録情報 CSV を取り込み、ローカル DB に正規化し、Claude Code から MCP 経由で検索・照会できるようにする MVP プロジェクトです。

注意: 本ツールが返すのは農薬登録情報の検索結果であり、使用可否を保証するものではありません。実際に使用する前に、製品ラベルと最新の農薬登録情報を必ず確認してください。

ドキュメント

• CLAUDE.md: プロジェクト方針と運用ルールの要点
• docs/MVP_DESIGN.md: 設計（アーキテクチャ、データモデル、検索仕様、MCP tool 仕様）
• docs/BACKLOG.md: マイルストーンとバックログ
• docs/DEVELOPMENT.md: 開発ガイド（技術スタック、環境変数、実行コマンド）

必要要件

• Python 3.12+
• uv

セットアップ

# 依存関係のインストール
uv sync

# Lint / format
uv run ruff check .
uv run ruff format .

# テスト
uv run pytest

データの取り込み

FAMIC の農薬登録情報 CSV/ZIP を data/raw/ に配置してから取り込みます。

uv run python -m pesticide_mcp.import_famic --source-dir ./data/raw --db ./data/pesticides.duckdb

FAMIC の登録基本部（例: R0807010.zip）と登録適用部一・二（例: R0807011/012.zip）を data/raw/ に置いて実行します。ZIP のまま取り込めます。主なオプション:

• --source-month YYYY-MM: 更新年月を明示（省略時はファイル名から推定）
• --dry-run: DB へ書き込まず解析・検証のみ

再実行しても pesticides / applications の内容は同じになります（取り込み履歴は source_imports に追記）。

Claude Code への MCP 接続

ローカル stdio MCP として接続します。

claude mcp add --transport stdio pesticide-registry \
  -- uv run python -m pesticide_mcp.server

プロジェクト共有用に .mcp.json.example を用意しています。コピーして利用してください。

cp .mcp.json.example .mcp.json

環境変数は以下を利用できます（詳細は docs/DEVELOPMENT.md）。

変数名	用途	既定値
PESTICIDE_DB_PATH	DuckDB ファイルパス	./data/pesticides.duckdb
PESTICIDE_SOURCE_DIR	FAMIC ZIP/CSV 保存先	./data/raw

接続後、Claude Code から dataset_status を呼ぶと取り込み状態を確認できます。

公開している MCP tools

いずれも「登録情報の検索結果」を返すもので、使用可否の判定は行いません。

tool	用途	主な入力
dataset_status	取り込み状態（件数・出典・取り込み日時）を返す	（なし）
search_pesticides	農薬基本情報を検索	name / register_no / active_ingredient / pesticide_type
get_pesticide_by_register_no	登録番号で基本情報＋適用サマリを取得	register_no（12345/0012345 両対応）
get_applications	適用情報を検索	crop / pest / pesticide_name / register_no / usage_method
check_registered_use	条件に該当する登録行候補を返す（可否判定ではない）	pesticide_name_or_register_no + crop (+ pest / usage_method)

各レスポンスには出典（source）と注意文（safety_notice）が含まれ、check_registered_use は allowed のような可否を断定するフィールドを返しません。

使い方（Claude Code での自然文例）

- 「登録番号 12345 の農薬を見て」                → get_pesticide_by_register_no
- 「除虫菊で農薬を検索して」                      → search_pesticides
- 「りんごの黒星病に登録のある適用を出して」      → get_applications
- 「ダコニールはりんごの黒星病に登録がある？登録行を出して」 → check_registered_use

check_registered_use は「使えます」と断定せず、該当する登録行の候補と根拠フィールド （作物名・適用病害虫雑草名・使用時期・使用方法・使用回数・総使用回数など）を返します。 Claude が結果を説明するときの返答テンプレートは docs/DEVELOPMENT.md を参照してください。

データソースと利用条件

• 一次データ: FAMIC 農薬登録情報ダウンロード CSV
• 補助（任意）: WAGRI 農薬情報取得 API
• 外部公開・二次配信を行う場合は、FAMIC/WAGRI の利用条件・表示条件を必ず再確認してください。