MetaMesh-UGA

MetaMesh-UGA

MCP 操作系统 — 面向 AI Agent 和 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 服务，每 6 小时从官方 MCP registry 同步一次
• Stripe 计费： 已上线 — Agent 可充值美元余额，并按调用次数付费
• x402 支付： 已实现；需配置钱包后方可启用（参见 /v1/x402/info）

MetaMesh-UGA 是 MCP 操作系统：一个无服务器、原生支持边缘计算的控制平面，通过单一端点发现、验证、评分、路由、监控和扩展 MCP 服务。

它整合了 registry 同步、语义发现、信任评分、策略执行、安全扫描、生命周期管理、智能路由、多级缓存、可靠性机制、自愈和实时分析，让 MCP 基础设施能够用于生产环境中的 AI Agent。

数秒即可连接：将任意 MCP 客户端（Claude、Windsurf、Cursor、Antigravity）指向 https://api.metamesh-uga.dev/mcp，或注册 Agent 以获取编程接口 API 密钥。无论采用哪种方式，都能访问经过筛选、可信且经过基准测试的 MCP 服务目录。

🚀 功能

• MCP 操作系统：控制平面 + 数据平面，用于管理整个 MCP 生态系统
• 统一 Registry：提供联邦、镜像和快照功能的唯一事实来源
• 智能发现：支持关键词、语义搜索、能力图谱和基于意图的发现
• 信任引擎：根据正常运行时间、延迟、成功率和安全性计算声誉评分
• 智能路由：支持加权、延迟、地理位置、成本和健康状况路由
• 可靠性层：包含熔断器、重试、隔离、对冲和回退机制
• 多级缓存：内存 L1 + KV L2、TTL、模式失效
• 安全体系：依赖项扫描、CVE 检测、OPA/Rego 策略引擎
• 自愈：自动弃用、回滚恢复、基于健康状况的修复
• 分析：使用趋势、成本分析、性能指标，支持导出到 OTel/Prometheus
• 生命周期管理：从发现到归档的自动状态管理
• 无服务器：无需管理基础设施（Cloudflare Workers）
• WASM 运行时：安全执行编译为 WebAssembly 的 MCP 工具
• AI Agent 经济体系：原生支持 x402 Protocol（USDC 微支付）
• 变现：Free、Pro（$19/月）、Enterprise（$499/月）套餐
• 设置后即可忘记：通过 cron triggers 实现全面自动化

📋 要求

• 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. 配置 Secrets

# 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 Protocol

添加到 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 Agent 经济体系

两种互补的生产就绪型支付模式：

模式 A — Stripe 预付额度（推荐）

Agent 通过 Stripe Checkout 一次性充值美元余额，然后自动从余额中扣除每次调用的费用。无需逐次支付，也无需加密货币。

# 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 客户端无需账户即可继续使用。

模式 B — x402 加密货币（Base 上的 USDC）

x402 协议：Agent 使用链上 USDC 按次付费。发送 X-PAYMENT 标头；收到 HTTP 402 时，读取 accepts 要求。

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

支付流程

1. 调用付费资源（POST /v1/call）。启用计费且未附带付款时，网关会响应 HTTP 402，并返回标准的 accepts 要求正文（scheme exact、network base、asset USDC、payTo、maxAmountRequired）。
2. Agent 构造已签名的付款，并通过 X-PAYMENT 标头（base64 JSON）重试。
3. 网关通过已配置的 facilitator 验证并结算付款，然后返回结果，以及包含链上交易的 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 表中（默认每次调用 $0.001，批量调用 $0.0005）。

📊 架构

MetaMesh-UGA 采用受现代服务网格启发的双层架构。

┌─────────────────────────────────────────────────────────────────────────────┐
│                      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/月	Dedicated 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

---

“设置后无需操心”已成为现实。🚀