MetaMesh-UGA

MetaMesh-UGA

MCP オペレーティングシステム — AI エージェントと MCP インフラストラクチャのためのサーバーレスコントロールプレーン

設定したらあとはおまかせ | インフラ不要 | サーバーレス | エッジネイティブ | MCP オペレーティングシステム

ライブステータス

• ゲートウェイ： https://api.metamesh-uga.dev — 稼働中
• ダッシュボード： https://dashboard.metamesh-uga.dev
• MCP エンドポイント： https://api.metamesh-uga.dev/mcp（HTTP 経由の JSON-RPC）
• MCP Registry： dev.metamesh-uga/metamesh-uga v2.0.0 — 公開済み・最新
• インデックス済みツール： 13,000 以上の MCP サーバー。公式 MCP レジストリから 6 時間ごとに同期
• Stripe 課金： 稼働中 — エージェントは USD 残高をチャージし、呼び出しごとに課金されます
• x402 決済： 実装済み。ウォレット設定により有効化が制限されます（/v1/x402/info を参照）

MetaMesh-UGA は MCP オペレーティングシステムです。単一のエンドポイントの背後で MCP サーバーを発見、検証、評価、ルーティング、監視、拡張する、サーバーレスかつエッジネイティブなコントロールプレーンです。

レジストリ同期、セマンティック検索、信頼性スコアリング、ポリシー適用、セキュリティスキャン、ライフサイクル管理、スマートルーティング、多層キャッシュ、信頼性パターン、自己修復、リアルタイム分析を組み合わせ、AI エージェント向けに MCP インフラストラクチャを本番環境で利用できる状態にします。

数秒で接続できます。任意の MCP クライアント（Claude、Windsurf、Cursor、Antigravity）を https://api.metamesh-uga.dev/mcp に接続するか、エージェントを登録してプログラムから使える API キーを取得してください。どちらの方法でも、厳選され、信頼性が確認され、ベンチマーク済みの MCP サーバーカタログを利用できます。

🚀 特長

• MCP オペレーティングシステム：MCP エコシステム全体を管理するコントロールプレーン＋データプレーン
• 統合レジストリ：フェデレーション、ミラーリング、スナップショットに対応した信頼できる唯一の情報源
• スマートディスカバリー：キーワード検索、セマンティック検索、機能グラフ、インテントベースのディスカバリー
• 信頼性エンジン：稼働時間、レイテンシ、成功率、セキュリティに基づく評価スコア
• スマートルーティング：重み付け、レイテンシ、地域、コスト、健全性に基づくルーティング
• 信頼性レイヤー：サーキットブレーカー、リトライ、バルクヘッド、ヘッジング、フォールバック
• 多層キャッシュ：インメモリ L1＋KV L2、TTL、パターン無効化
• セキュリティファブリック：依存関係スキャン、CVE 検出、OPA/Rego ポリシーエンジン
• 自己修復：自動非推奨化、ロールバックによる復旧、健全性に基づく修復
• 分析：利用傾向、コスト分析、パフォーマンス指標、OTel/Prometheus へのエクスポート
• ライフサイクル管理：ディスカバリーからアーカイブまでの状態を自動管理
• サーバーレス：管理が必要なインフラストラクチャは不要（Cloudflare Workers）
• WASM ランタイム：WebAssembly にコンパイルされた MCP ツールを安全に実行
• AI エージェントエコノミー：x402 Protocol にネイティブ対応（USDC のマイクロペイメント）
• 収益化：Free、Pro（$19/月）、Enterprise（$499/月）プラン
• 設定したらあとはおまかせ：cron トリガーによる完全自動化

📋 要件

• Node.js 18+
• Go 1.21+（CLI 用）
• Cloudflare アカウント（無料プランで十分）
• Stripe アカウント（決済用）

🛠️ インストール

1. クローンとセットアップ

git clone https://github.com/SiouxTXT/metamesh-uga.git
cd metamesh-uga
npm install

2. Cloudflare の設定

# Installa Wrangler
npm install -g wrangler

# Login a Cloudflare
wrangler login

# Crea database D1
wrangler d1 create metamesh-catalog

# Crea KV namespace
wrangler kv:namespace create "CACHE"

# Crea R2 bucket
wrangler r2 bucket create metamesh-wasm

3. シークレットの設定

# Stripe
wrangler secret put STRIPE_SECRET_KEY
wrangler secret put STRIPE_WEBHOOK_SECRET

# JWT
wrangler secret put JWT_SECRET

# Alerting (opzionale)
wrangler secret put TELEGRAM_BOT_TOKEN
wrangler secret put TELEGRAM_CHAT_ID

# Admin
wrangler secret put ADMIN_KEY

4. データベースのマイグレーション

wrangler d1 execute metamesh-catalog --file=./shared/migrations/001_init.sql

5. デプロイ

# Deploy Workers
npm run deploy:workers

# Deploy Dashboard
cd packages/dashboard
npm install
npm run deploy

6. CLI のインストール

cd cli
go build -o metamesh

# Installa globalmente
mv metamesh /usr/local/bin/

# O usa direttamente
./metamesh connect

🎯 使い方

CLI ツール

# Connetti al gateway (salva la config locale)
metamesh connect

# Chiama un tool (raggiunge POST /v1/call)
metamesh call example.echo --message "hello"

# Lista tool disponibili
metamesh list --category demo

# Visualizza utilizzo
metamesh usage

REST API

# List tools (paginated, public)
curl "https://api.metamesh-uga.dev/v1/tools?limit=20&sort=popularity"

# Full-text search
curl "https://api.metamesh-uga.dev/v1/search?q=github"

# Execute a tool
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"tool": "example.echo", "params": {"message": "hello"}}' \
  https://api.metamesh-uga.dev/v1/call

MCP プロトコル

Devin／Cursor／Windsurf／Claude Desktop に追加します：

{
  "mcpServers": {
    "metamesh-uga": {
      "url": "https://api.metamesh-uga.dev/mcp",
      "transport": "http"
    }
  }
}

または、JSON-RPC 経由で直接テストします：

curl -X POST https://api.metamesh-uga.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

🤖 AI エージェントエコノミー

本番環境に対応した、相互補完的な2種類の決済モデルです。

Model A — Stripe によるプリペイドクレジット（推奨）

エージェントは Stripe Checkout を利用して一度だけ USD 残高をチャージします。その後、呼び出しごとの料金が残高から自動的に差し引かれます。呼び出しごとの手数料はなく、暗号資産も不要です。

# 1. Register an agent (returns agent_id + api_key, shown once)
curl -X POST https://api.metamesh-uga.dev/v1/agent/register \
  -H "Content-Type: application/json" -d '{"name":"My Agent"}'

# 2. Top up via Stripe (returns a Checkout URL)
curl -X POST https://api.metamesh-uga.dev/v1/agent/topup \
  -H "X-Agent-Id: agent_xxx" -H "X-Agent-Key: ak_xxx" \
  -H "Content-Type: application/json" -d '{"amount_usd": 10}'

# 3. Call tools — balance is debited per call
curl -X POST https://api.metamesh-uga.dev/v1/call \
  -H "X-Agent-Id: agent_xxx" -H "X-Agent-Key: ak_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tool":"example.echo","params":{"message":"hi"}}'

# 4. Check balance / history
curl https://api.metamesh-uga.dev/v1/agent/wallet -H "X-Agent-Id: agent_xxx" -H "X-Agent-Key: ak_xxx"
curl https://api.metamesh-uga.dev/v1/billing/info

オペレーターによる有効化：

wrangler secret put STRIPE_SECRET_KEY --env production       # sk_live_... or sk_test_...
wrangler secret put STRIPE_WEBHOOK_SECRET --env production   # whsec_... (Stripe webhook signing secret)
# Point a Stripe webhook to: https://api.metamesh-uga.dev/v1/stripe/webhook (event: checkout.session.completed)
# Optionally set BILLING_ENABLED="true" in wrangler.toml to require payment for ALL callers.

Stripe が未設定の場合、匿名での呼び出しは無料のままで、/v1/agent/topup は明確な 503 を返します。

現在の本番環境の状態： Stripe（ライブキー）と checkout.session.completed Webhook が設定されており、BILLING_ENABLED="true" です。課金は REST の POST /v1/call エンドポイントに適用されます。呼び出しごとにすべての呼び出し元へ課金されるため、先に /v1/agent/topup からチャージしてください。公開 MCP エンドポイント（POST /mcp）は、ディスカバリー（tools/list）とネイティブの metamesh.* ツールについては無料のままなので、MCP クライアントはアカウントなしでも引き続き利用できます。

Model B — x402 による暗号資産決済（Base 上の USDC）

x402 プロトコル：エージェントは USDC によるオンチェーン決済で、呼び出しごとに支払います。X-PAYMENT ヘッダーを送信してください。HTTP 402 が返された場合は、accepts 要件を確認してください。

curl https://api.metamesh-uga.dev/v1/x402/info

決済フロー

1. 有料リソースを呼び出します（POST /v1/call）。課金が有効で、決済情報が添付されていない場合、ゲートウェイは標準の accepts 要件を含む HTTP 402 を返します（スキーム exact、ネットワーク base、資産 USDC、payTo、maxAmountRequired）。
2. エージェントは署名付き決済を作成し、X-PAYMENT ヘッダー（base64 JSON）を付けて再試行します。
3. ゲートウェイは設定済みのファシリテーターを介して検証と決済を行い、結果とともにオンチェーン取引を示す X-PAYMENT-RESPONSE ヘッダーを返します。

有効化（オペレーター）

x402 は実装済みですが、受取ウォレットを設定するまで無効です。

# In wrangler.toml [env.production.vars]
X402_ENABLED = "true"
X402_PAY_TO  = "0xYourBaseWallet"
# X402_FACILITATOR_URL and USDC_CONTRACT have working defaults

ツールごとの料金は tool_pricing テーブルに設定されています（デフォルトは1回あたり $0.001、一括処理は $0.0005）。

📊 アーキテクチャ

MetaMesh-UGA は、最新のサービスメッシュに着想を得た2層アーキテクチャを採用しています。

┌─────────────────────────────────────────────────────────────────────────────┐
│                      META MESH-UGA — MCP OPERATING SYSTEM                 │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                     CONTROL PLANE                                   │   │
│  │                                                                     │   │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │   │
│  │  │ Registry │ │ Discovery│ │  Trust   │ │  Policy  │ │ Lifecycle│ │   │
│  │  │  Engine  │ │  Engine  │ │  Engine  │ │  Engine  │ │  Manager │ │   │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │   │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐             │   │
│  │  │ Security │ │Benchmark │ │Analytics │ │  Config  │             │   │
│  │  │  Scanner │ │  Engine  │ │  Engine  │ │  Engine  │             │   │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘             │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                    │                                        │
│                                    ▼                                        │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                       DATA PLANE                                    │   │
│  │                                                                     │   │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │   │
│  │  │  Routing │ │   Cache  │ │  Health  │ │  Proxy   │ │  Rate    │ │   │
│  │  │  Engine  │ │  Engine  │ │  Engine  │ │  Engine  │ │ Limiting │ │   │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                    │                                        │
│                                    ▼                                        │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                         MCP ECOSYSTEM                               │   │
│  │  (Server MCP A, B, C, D, E...)                                     │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────────────────┘

• コントロールプレーン：判断、設定、オーケストレーション、分析。
• データプレーン：リクエストの実行、ルーティング、キャッシュ、リアルタイムのヘルスチェック。

詳しくは、docs/ARCHITECTURE.md をご覧ください。

💰 料金プラン

プラン	料金	機能
Free	€0	月1,000回の呼び出し、100 req/min
Pro	$19/月	呼び出し無制限、1,000 req/min
Enterprise	$499/月	専用 VPC、10,000 req/min、SLA 99.9%

📁 リポジトリ構成

metamesh-uga/
├── packages/
│   ├── gateway/            # Data Plane: API Gateway, Routing, Cache, Proxy, Reliability
│   ├── discovery/          # Control Plane: Discovery Engine
│   ├── registry/           # Control Plane: Registry Engine (federation, mirroring, snapshot)
│   ├── trust/              # Control Plane: Trust Engine
│   ├── security/           # Control Plane: Security Scanner
│   ├── policy/             # Control Plane: Policy Engine
│   ├── benchmark/          # Control Plane: Benchmark Engine
│   ├── lifecycle/          # Control Plane: Lifecycle Manager
│   ├── recommendation/     # Control Plane: Recommendation Engine
│   ├── cost/               # Control Plane/Data Plane: Cost Optimizer
│   ├── compatibility/      # Control Plane: Compatibility Engine
│   ├── intelligence/       # Control Plane: AI Intelligence Layer
│   ├── analytics/          # Control Plane: Analytics Engine
│   ├── health/             # Data Plane: Health Engine
│   ├── config/             # Control Plane: Config Engine
│   ├── cache/              # Data Plane: Advanced Cache Engine
│   ├── self-healing/       # Data Plane: Self-Healing Engine
│   ├── aggregator/         # Motore di aggregazione
│   ├── inserter/           # Motore di inserimento
│   ├── updater/            # Motore di aggiornamento
│   ├── eliminatore/        # Motore di eliminazione
│   ├── alerts/             # Alerting Worker
│   ├── agent-billing/      # Billing per AI Agent
│   ├── dashboard/            # Cloudflare Pages (React)
│   └── landing/            # Landing page
├── cli/                    # CLI Tool (Go)
├── shared/                 # Librerie condivise
│   ├── src/
│   │   ├── auth.js         # Autenticazione
│   │   ├── ratelimit.js    # Rate limiting
│   │   ├── wasm-runtime.js # WASM execution
│   │   └── x402.js         # x402 Protocol
│   └── migrations/         # Database migrations
├── docs/                   # Documentazione
└── wrangler.toml           # Configurazione Cloudflare

🔧 環境設定

# .env
CLOUDFLARE_API_TOKEN=xxx
CLOUDFLARE_ACCOUNT_ID=xxx
D1_DATABASE_ID=xxx
JWT_SECRET=xxx
STRIPE_SECRET_KEY=sk_test_xxx
STRIPE_WEBHOOK_SECRET=whsec_xxx
TELEGRAM_BOT_TOKEN=xxx
TELEGRAM_CHAT_ID=xxx

🧪 テスト

# Test locale
wrangler dev --config packages/gateway/wrangler.toml

# Test API
curl http://localhost:8787/health

📝 ライセンス

MIT License - LICENSE をご覧ください。

👤 作成者

Davanzo Keoma - GitHub

---

「一度設定すれば、あとはおまかせ」が現実になりました。🚀