Skip to main content
Glama
deenesjakoruzh
nohosa001-pixel

Critical Raw Minerals & Urban Mining Oracle (x402)

by nohosa001-pixel
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

重要レアメタル＆アーバンマイニング・オラクル（minerals-oracle-x402）

Python 3.11+ FastAPI Protocol Agent Protocol MCP

自律型トレーディング、サプライチェーン、RWA（実物資産）エージェント向けに設計された、高性能な決定論的マイクロオラクルサービス。重要レアメタル物理商品のリアルタイムスポット価格、COMEX/LMEクロスエクスチェンジ裁定スプレッド、アーバンマイニングスクラップのベンチマーク歩留まり評価を提供します。

⚡ 主な特徴

  1. 正規化された重要コモディティ価格フィード:

    • 銀（Ag）: LBMAおよびCOMEXスポット価格をUSD/troy_oz、USD/g、USD/kgで提供。

    • 白金（Pt）: LPPMおよびNYMEXスポット価格をUSD/troy_oz、USD/gで提供。

    • 銅（Cu）: LMEグレードAカソードおよびCOMEX価格をUSD/mt、USD/lb、USD/kgで提供。

    • リチウム（Li）: バッテリーグレード99.5% $\text{Li}_2\text{CO}_3$ / $\text{LiOH}$ をUSD/mt、USD/kgで提供。

    • レアアース（NdDy）: 永久磁石グレードのネオジム・ジスプロシウム（$\text{PrNd}/\text{DyFe}$）複合価格をUSD/kgで提供。

  2. 地域間裁定取引とベーシススプレッド:

    • 越洋輸送費と輸入関税を考慮したCOMEX対LME銅裁定計算。

    • COMEX対LBMAロコ・ロンドン銀スプレッド。

    • SMM中国国内対Fastmarkets CIFロッテルダム・リチウムのプレミアム/ディスカウント。

    • NYMEX対LPPM白金スプレッド。

  3. アーバンマイニング＆サーキュラーエコノミー評価エンジン:

    • EV_BATTERY_BLACK_MASS: $\text{Li}$、$\text{Ni}$、$\text{Co}$、$\text{Mn}$の湿式冶金回収。支払可能な回収歩留まりと処理費（TC/RC）を考慮。

    • AUTO_CATALYST_CERAMIC: 使用済み触媒コンバーターのセラミックモノリス分析からのPGM回収（$\text{Pt}$、$\text{Pd}$、$\text{Rh}$）。

    • E_WASTE_HIGH_GRADE_PCB: シュレッダー処理されたPCB原料からの貴金属・ベースメタル抽出（$\text{Au}$、$\text{Ag}$、$\text{Cu}$）。

    • WIND_EV_PERMANENT_MAGNETS: 分離されたレアアース酸化物（$\text{Nd}$、$\text{Dy}$、$\text{Pr}$）のためのNdFeBスクラップリサイクル。

  4. Base上のx402によるWeb3マネタイゼーション:

    • Base（チェーンID 8453）上のHTTP 402チャレンジ・レスポンスによるマイクロペイメント（クエリあたり0.005 USDC）を強制。

    • ネイティブBase USDCトークン: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913。

    • EIP-712/EIP-191暗号署名とファシリテーター検証をサポート。

  5. マルチエージェント標準ネイティブ:

    • Google AP2（/.well-known/ap2）: Agent Protocol v2マニフェスト。

    • Model Context Protocol（MCP）: ツールスキーマ定義（mcp_tool_spec.json）および/mcp/invokeディスパッチャー。

    • OpenAPI / Swagger（/docs）: 標準の機械可読および対話型APIドキュメント。

Related MCP server: hyperd-mcp

📁 リポジトリ構成

minerals-oracle-x402/
├── app/
│   ├── __init__.py
│   ├── main.py              # FastAPI application, routing & MCP endpoints
│   ├── feed_engine.py       # Deterministic commodity pricing, spread & scrap engine
│   ├── x402_verifier.py     # HTTP 402 challenge & EIP-712 payment verifier
│   └── schemas.py           # Pydantic data contracts & schemas
├── tests/
│   ├── __init__.py
│   └── test_client.py       # Autonomous agent payment test suite
├── .well-known/
│   └── ap2.json             # Google Agent Protocol AP2 manifest
├── mcp_tool_spec.json       # FastMCP tool definition for LLM agents
├── Dockerfile               # Ultra-lightweight multi-stage container
├── requirements.txt         # Python dependencies
└── README.md                # Documentation & quickstart

🚀 クイックスタート

1. ローカルセットアップ

# Clone and enter directory
cd minerals-oracle-x402

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run development server
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

対話型ドキュメントはhttp://localhost:8000/docsで利用可能です。

2. Dockerでの実行

# Build lightweight container
docker build -t minerals-oracle-x402 .

# Run container
docker run -p 8000:8000 minerals-oracle-x402

💳 x402支払いフロー仕様

sequenceDiagram
    autonumber
    actor Agent as Autonomous AI Agent
    participant Oracle as minerals-oracle-x402
    participant Base as Base Network (USDC)

    Agent->>Oracle: GET /api/v1/oracle/prices
    Oracle-->>Agent: HTTP 402 Payment Required<br/>(Nonce, Price: 0.005 USDC, Base Chain ID: 8453)
    Note over Agent: Agent signs payment challenge<br/>using private key (EIP-712/EIP-191)
    Agent->>Oracle: GET /api/v1/oracle/prices<br/>Header: Authorization: x402 <base64_payload>
    Oracle->>Oracle: Verify signature / Facilitator settle
    Oracle-->>Agent: HTTP 200 OK<br/>Certified Oracle Feeds & Attestation Hashes

支払い認証ヘッダー形式

Authorization: x402 eyJub25jZSI6ICIxYTIz...IiwgInNpZ25hdHVyZSI6ICIweDk5...In0=

デコードされたJSONペイロードには以下が含まれます:

{
  "nonce": "7f8b92c4a90184b2ef019a823b102938",
  "signature": "0x...",
  "signer": "0xYourAgentWalletAddress"
}

🤖 MCP（Model Context Protocol）統合

Claude Desktop、Cursor、Gemini、またはAntigravityエージェントで使用するには、mcp_tool_spec.jsonを読み込んでください。

利用可能なツール:

  1. get_mineral_prices: 現在の全スポット価格と単位換算を取得。

  2. get_arbitrage_spreads: COMEX/LME/SMMベーシススプレッドとマージンを取得。

  3. calculate_urban_mining_value: EVブラックマス、自動車触媒、電子廃棄物、または永久磁石のバッチ回収歩留まりを計算。

PythonエージェントMCPツール呼び出しの例:

import httpx

resp = httpx.post(
    "http://localhost:8000/mcp/invoke",
    json={
        "name": "calculate_urban_mining_value",
        "arguments": {
            "scrap_category": "EV_BATTERY_BLACK_MASS",
            "quantity_metric_tons": 5.0,
            "custom_assay_overrides": {"Li": 4.1, "Co": 6.5}
        }
    },
    headers={"X-Dev-Bypass": "true"}  # Or with valid x402 signature
)
print(resp.json())

🧪 テストの実行

402チャレンジフロー、EIP-712暗号検証、スクラップ計算、AP2エンドポイントを検証する自動テストスイートを実行:

pytest -v tests/test_client.py

📜 ライセンス

MITライセンス。自律エージェントコマースと重要鉱物レジリエンスのために構築されました。

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • AgentScrape

    Pay-per-call web scraping for AI agents via x402 on Base USDC. Six tools, no signup.

  • agent-web-reader

    Pay-per-call data tools for AI agents: crypto signal, web reader, SEO audit. x402 USDC on Base.

  • Blixtworks

    63 pay-per-call tools for agents: vision, text, data, web, blockchain. USDC on Base via x402.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nohosa001-pixel/minerals-oracle-x402'

If you have feedback or need assistance with the MCP directory API, please join our Discord server