Battery ERP — 材料、セル、パック、およびサプライチェーン管理。リアルタイムのコモディティ価格とFabric Lakehouse分析を備えています。

バッテリーのバリューチェーン全体をカバー: リチウム、コバルト、ニッケル、マンガン、黒鉛から、セル化学(NMC-811、NCA、LFP、LMO)、BOM原価計算、サプライヤースコアリング、在庫管理、what-ifコストシナリオを備えたバッテリーパックまで。

mcp-name: io.github.icohangar-ops/battery-erp

これは何か

Battery ERPは、原材料の調達からセル製造、パック組み立てまでのバッテリーのバリューチェーン全体を管理します。すべてのコストは、特定の材料、サプライヤー、価格ポイントにトレース可能です。

Related MCP server: Factory Insight MCP Server

クイックスタート

# From PyPI — https://pypi.org/project/battery-erp/
python3 -m pip install 'battery-erp[mcp]'   # MCP tools
python3 -m pip install 'battery-erp[api]'   # REST adapter

# From source
git clone https://github.com/icohangar-ops/battery-erp.git
cd battery-erp
python3 -m pip install -e '.[dev]'
PYTHONPATH=src python3 -m pytest tests/ -v

# Domain modules
python3 -c "
from battery_erp.pricing import calculate_cell_cost_summary, get_material_price_table
prices = get_material_price_table()
for chem in ['NMC-811', 'NMC-622', 'NCA', 'LFP', 'LMO']:
    r = calculate_cell_cost_summary(chem, 50.0, prices)
    print(f'{chem}: \${r[\"cost_per_kwh\"]:.1f}/kWh (BOM: \${r[\"bom_cost_usd\"]:.2f})')
"

アーキテクチャ

                    ┌──────────────────────────────────────┐
                    │  Raw Materials (20+ tracked)          │
                    │  Lithium · Cobalt · Nickel · Mn · Gr  │
                    └──────────────┬───────────────────────┘
                                   │ BOM
                    ┌──────────────▼───────────────────────┐
                    │  Cell Chemistries                     │
                    │  NMC-811 · NMC-622 · NCA · LFP · LMO  │
                    └──────────────┬───────────────────────┘
                                   │ cells + components
                    ┌──────────────▼───────────────────────┐
                    │  Battery Packs                        │
                    │  EV · ESS · Consumer · Industrial     │
                    └──────────────────────────────────────┘

Side modules:
  ┌─────────────────┐  ┌──────────────────┐  ┌──────────────────┐
  │ Supplier Scoring │  │ Inventory Mgmt   │  │ Cost Scenarios    │
  │ Composite 0-100  │  │ Reorder logic    │  │ What-if analysis  │
  │ A/B/C/D grades   │  │ Status tracking  │  │ Price shock model │
  └─────────────────┘  └──────────────────┘  └──────────────────┘

コアモジュール

battery_erp.core.models

すべてのドメインデータクラス:

• RawMaterial — 価格、HSコード、危険性を含む材料カタログ

• CellChemistry — エネルギー密度とサイクル寿命を持つNMC-111/622/811、NCA、LFP、LMO

• BatteryCell — セル仕様(容量、電圧、フォームファクター、重量)

• BatteryPack — パック組み立て(セル+ BMS + 熱管理)

• BOMItem — 廃棄率を含む部品表(BOM)ラインアイテム

• Supplier — 品質評価、リードタイム、認証を含むサプライヤーカタログ

• InventoryRecord — 再発注ロジック付きの倉庫ポジション

• PurchaseOrder — POライフサイクル追跡

• ManufacturingBatch — 生産バッチ歩留まり追跡

• PriceHistory — コモディティ価格時系列

battery_erp.core.rules

決定論的ビジネスルール:

• rollup_bom_cost() — 材料内訳と廃棄コストを含む総BOMコスト

• calculate_cell_bom() — 任意の化学組成の代表的なBOMを生成

• calculate_pack_bom() — パックレベルのBOM(セル+ケーシング+ BMS +冷却)

• update_inventory_status() — in_stock/low/out_of_stockを再計算

• check_reorder_suggestions() — PO提案を生成

• calculate_batch_metrics() — 製造歩留まりを集計

• analyze_price_history() — ボラティリティを含む価格トレンド分析

• estimate_cell_cost_impact() — what-ifコストシナリオモデリング

• calculate_pack_metrics() — パックエネルギー密度と効率

battery_erp.supply_chain

サプライチェーン管理:

• score_supplier() — 複合スコア(品質35%、OTD 35%、リードタイム20%、認証10%)

• rank_suppliers() — スコアでランク付け、材料でフィルタリング

• create_purchase_order() — サプライヤーデータからのPO作成

• analyze_po_pipeline() — POパイプライン分析(遅延検出、リードタイム追跡)

• suggest_dual_sourcing() — デュアルソーシング戦略の推奨

battery_erp.pricing

コモディティ価格設定:

• get_material_price_table() — 20以上のバッテリー材料のデフォルト価格

• calculate_cell_cost_summary() — 化学組成ごとのクイックコスト見積もり

• update_prices_from_alpha_vantage() — ライブコモディティ価格の取得

• update_prices_from_fred() — マクロ経済指標

battery_erp.analytics

レポーティング:

• generate_inventory_report() — 完全な在庫健全性ダッシュボード

• generate_supply_chain_report() — サプライヤー+ POパイプラインレポート

• generate_manufacturing_report() — 歩留まり指標

• generate_pricing_report() — 化学コスト比較+価格トレンド

化学コスト比較(デフォルト価格、50Ahセル)

Microsoft Fabric統合

Fabricノートブック

Deltaテーブルスキーマ

Fabricクイックスタート

1. fabric_setup_lakehouse.pyを実行して11のDeltaテーブルすべてを作成

2. fabric_cost_dashboard.pyを実行して完全な分析ダッシュボードを表示

3. ダッシュボードの対象: 化学コスト比較、パックレベル原価計算、在庫健全性、サプライヤースコアカード、価格トレンド、製造歩留まり、コストシナリオ

在庫アダプター(REST + MCP)

Battery ERPはドメインライブラリであり、ホスト型ERPではありません。SMS / text-lineおよびエージェントワークフロー向けに、共有のInventoryServiceが薄いREST APIとMCPサーバーの両方の下に配置されています。詳細: docs/INTEGRATION.md。

SMS / ClickSend          Cursor / Claude (stdio MCP)
        │                         │
        ▼                         ▼
  REST API (port 8088)      battery_erp.mcp
        └──────────┬──────────────┘
                   ▼
           InventoryService
                   ▼
        InMemoryInventoryStore (demo)
                   ▼
          Human bin confirmation

ブラウザからMCPを呼び出さないでください。RESTとMCPは別々のターミナルで実行してください。

インストール(macOS / zsh)

python3を使用してください。zshがグロブしないようにpipのextrasを引用符で囲んでください:

cd ~/Desktop/icohangar-repos/battery-erp
python3 -m pip install -e '.[dev]'   # api + mcp + pytest

ターミナルA — REST(テキストラインバックエンド)

cd ~/Desktop/icohangar-repos/battery-erp
export BATTERY_ERP_CONFIRM_TOKEN=dev-secret
export BATTERY_ERP_AUDIT_LOG=/tmp/battery-erp-audit.jsonl
PYTHONPATH=src python3 -m battery_erp.api
# Uvicorn → http://127.0.0.1:8088

curl -s http://127.0.0.1:8088/health
curl -s http://127.0.0.1:8088/inventory/lookup/lithium

ターミナルB — MCP(エージェント / Cursorのみ)

ターミナルAを実行したままにしてください。新しいターミナルで:

cd ~/Desktop/icohangar-repos/battery-erp
export BATTERY_ERP_CONFIRM_TOKEN=dev-secret
PYTHONPATH=src python3 -m battery_erp.mcp

そのプロセスはstdio上で静かです — MCPホストでは正常です。これをAPIターミナルに貼り付けないでください。

Cursor MCP設定

~/.cursor/mcp.jsonに追加(絶対パス; pythonではなくpython3):

{
  "mcpServers": {
    "battery-erp": {
      "command": "python3",
      "args": ["-m", "battery_erp.mcp"],
      "env": {
        "PYTHONPATH": "/Users/YOU/Desktop/icohangar-repos/battery-erp/src",
        "BATTERY_ERP_CONFIRM_TOKEN": "replace-me",
        "BATTERY_ERP_AUDIT_LOG": "/tmp/battery-erp-audit.jsonl"
      }
    }
  }
}

その後、CursorでMCPサーバーをリロードしてください。公開されるツール: lookup_inventory、get_inventory_status、get_inventory_record、list_inventory、create_bin_check_request、record_bin_confirmation。

変更を伴うビン確認にはBATTERY_ERP_CONFIRM_TOKENが必要で、オプションでBATTERY_ERP_AUDIT_LOGにJSONL監査を書き込みます。

ディレクトリ / レジストリパッケージング: PUBLISH.md (glama.json、Dockerfile、server.json)を参照してください。mainへのマージ後、Glamaで@icohangar-ops/battery-erpとしてクレームしてください。

テスト

PYTHONPATH=src python3 -m pytest tests/ -v
# Domain tests + inventory service / REST / MCP scaffold

ユースケース

• セルメーカー — 化学組成間のBOMコスト追跡、歩留まり最適化

• パックインテグレーター — パックレベルのコスト見積もり、サプライヤー選定

• 調達 — サプライヤースコアリング、デュアルソーシング、POパイプライン管理

• 財務 — コモディティ価格リスク、what-ifシナリオ、在庫評価

• 経営層 — $/kWhトレンド、サプライチェーンの回復力、コスト削減機会を示すダッシュボード

ライセンス

MIT。 LICENSEを参照してください。

CHPガバナンス

このリポジトリは、CubiczanのマルチエージェントAIシステム向け意思決定ガバナンスレイヤーであるConsensus Hardening Protocol (CHP)で強化されています。

プロトコルレイヤー

• R0ゲート: すべての決定はSolvable、Scoped、Valid、Worth_itチェックを通過する必要があります

• Foundation開示: 1〜3の最も弱い仮定、1〜2の無効化条件、1つの主要な脆弱性

• Adversarialレイヤー: フェーズ0とラウンド3での必須の悪魔の代弁者

• ステートマシン: EXPLORING → PROVISIONAL → PROVISIONAL_LOCK → LOCKED

• 第三者検証: ロック前の独立したCONFIRM/REJECT

ドメイン設定

• カテゴリ: 鉱業 / サプライチェーン

• Foundationしきい値: 75

• CFO精度ガード: 無効

コンプライアンス成果物

CHPバージョン

cognitive-mesh-orchestrator 0.1.0 | プロトコルドキュメント

デモ

ハンドヘルド — Parts Bin Text Line

ライブリードページからのモバイルキャプチャ (parts-bin-text-line--icohangar.replit.app)。 SMS → text-line → Battery ERP 在庫確認 → 人間によるビン確認。