Skip to main content
Glama
Alpha Sentinel Market Intelligence x402 MCP Server

Alpha Sentinel Market Intelligence x402 MCP Server

Alpha Sentinel - Market Intelligence x402 MCP Server

⭐ 链上赚取奖励的预测智能代理! ★

一个生产级 x402 市场服务,通过付费 MCP 工具为 AI 智能体提供实时加密市场监控、波动性警报和情绪分析。

🎯 任务

通过处理微支付 API 端点和 MCP 工具,提供具有 <30s 延迟的可操作实时市场情报。成功状态 = 可操作警报,每次调用 ROI 可衡量!

Related MCP server: Enterprise Crypto MCP Gateway

💰 定价

根据 x402 市场调研(中位价格为 $0.014,约 90% 低于 $0.10):

资源

价格

配额(专业版)

描述

price_feed()

$0.005

5000/月

实时价格查询

volatility_alerts()

$0.02

500/月

异常检测 + 阈值

sentiment_analysis()

$0.01

1000/月

社交情绪聚合

risk_assessment()

$0.03

300/月

多因素风险评分

market_report()

$0.15

50/月

综合每日报告

Tool Credit Pack

$1.00

100 calls

灵活积分包

免费层级: 每月 50 次调用,每分钟 5 次限流
专业层级: 无限配额,每分钟 120 次,优先结算

🛠️ MCP 工具

核心智能工具

  1. fetch_price() ⭐ 包含免费层级

    • 从 CoinGecko API 获取最新价格

    • 支持:BTC、ETH、前 100 种山寨币

    • 响应:{ symbol, price_usd, change_24h, volume }

  2. analyze_volatility()

    • 通过 Z-score 统计分析检测价格异常

    • 可配置阈值(默认:2σ)

    • 返回异常分数 + 警报级别

  3. aggregate_sentiment()

    • 从 X/Twitter、Reddit、Telegram 来源聚合

    • 基于 NLP 生成情绪评分(-1.0 至 +1.0)

    • 趋势检测与动量指标

  4. calculate_risk_score()

    • 多因素风险评估(波动性、流动性、相关性)

    • 风险等级:LOW/MEDIUM/HIGH/CRITICAL

    • 包含置信区间

  5. generate_market_report()

    • 综合每日/每周/每月报告

    • 整合所有数据源

    • PDF + JSON 输出格式

📦 +代表付费组合产品

  • 美国租赁尽职调查包(依赖城市合规集成层):$1.50

    • 涉及租赁许可证、违规单和租户权利

    • 多物业批量处理

    • 市政位置开放数据关联

  • 脉冲快讯:$0.05

    • 基链 + 市场指标综合分析

    • 12 区块采样深度

    • 实时现货价格集成

  • 信用决策费:$0.01

    • 低成本交易价查询层,用于常规交易前检查

    • 主网交易前即时反馈

🏗️ 架构

┌─────────────────────────────────────────────────────┐
│           Alpha Sentinel MCP Server                  │
├─────────────────────────────────────────────────────┤
│                                                      │
│  [MCP Layer]                                         │
│    ├─ FastMCP Server (stdio + SSE)                  │
│    └─ Tool Registry (SSOT)                          │
│                      │                              │
│  [Commerce Layer]                                    │
│    ├─ x402 Middleware (verify+settle)               │
│    ├─ Quota Management (free/pro tiers)             │
│    ├─ Challenge Cache (sync, 10s TTL)               │
│    └─ Stripe Integration (fiat rail fallback)       │
│                      │                              │
│  [Intelligence Layer]                                │
│    ├─ Price Feed (CoinGecko API)                    │
│    ├─ Sentiment Engine (X/Reddit/NLP)               │
│    ├─ Volatility Analyzer (statistical models)      │
│    └─ Risk Calculator (ML-enhanced)                 │
│                      │                              │
│  [On-Chain Layer]                                    │
│    ├─ CDP Facilitator (Base mainnet)                │
│    ├─ Ledger (spend/revenue tracking)               │
│    └─ Swarm Agency (buy-compose-resell)             │
│                                                      │
└─────────────────────────────────────────────────────┘

🚀 快速开始

前置条件

  • Python 3.12+

  • Redis(可选,用于生产环境)

  • x402 卖家凭证(与买家凭证分开!)

  • CoinGecko API 密钥(免费层级即可)

初始设置

# Clone and setup
git clone https://github.com/kwizzlesurp10-ctrl/alpha-sentinel-mcp
cd alpha-sentinel-mcp
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Configure environment
cp .env.example .env
nano .env  # Edit with your credentials

# Run locally
make up  # API (8403) + dashboard (5174)

环境变量

# Seller (receive revenue)
X402_PAY_TO_ADDRESS=0xAB745e5F...  # Separate from buyer!

# Buyer (hot wallet for spending)
EVM_PRIVATE_KEY=<your_buyer_key>    # NEVER on Render!

# APIs
COINGECKO_API_KEY=<your_key>
X_API_KEY=<twitter/x_api_key>       # Optional

# Commerce
STRIPE_SECRET_KEY=<your_stripe_key>  # Optional
REDIS_URL=redis://localhost:6379     # Optional

# Network
X402_DEFAULT_NETWORK=eip155:84532    # Base Sepolia dev
CDP_API_KEY_ID=<cdp_id>              # For mainnet selling
CDP_API_KEY_SECRET=<cdp_secret>

🔧 开发

运行测试

# Full test suite
make test

# Specific tests
pytest tests/test_mcp_tools.py -v
pytest tests/test_commerce.py -v

# Dashboard tests
cd dashboard && pnpm vitest run

添加新的 MCP 工具

按照 app/tools_registry.py 中的模式进行操作:

  1. 将工具定义添加到 TOOL_SPECS 列表

  2. 在 app/intelligence/ 目录中实现相应的处理程序

  3. 在 app/mcp_server.py 中注册

  4. 在 README 中新增工具表格行

  5. 运行 scripts/capture_goal_evidence.py 更新已记录的测试结果

要记住: 工具注册表是唯一的事实来源!必须同步修改所有相关文件,否则 CI 将会失败。

CI/CD 流程

GitHub Actions 包括:

  • ✅ Pytest(Python 3.12)

  • ✅ Vitest(仪表盘)

  • ✅ 安全扫描(秘密扫描、SAST)

  • ✅ 覆盖率检查(>80%)

  • ✅ Docker 构建与推送

📊 可观测性

指标端点

  • /stats - 实时使用统计数据

  • /ledger/{name} - 结算历史记录

  • /quota/{agent_id} - 剩余配额

  • /swarm/stats - 自治智能体指标

事件流

订阅 SSE 服务 /events 以获取实时:

  • 工具执行日志

  • 结算确认

  • 配额更新

  • Swarm 阶段转换

🔒 安全性

  • ✅ 不会提交任何私钥到仓库(.env 始终被忽略)

  • ✅ 对所有 URL 探测启用 SSRF 防御

  • ✅ 按 agent_id 对请求频率进行限制

  • ✅ 结算使用幂等键

  • ✅ 支持通过 KEY_PROVIDER 服务接口进行密钥轮换

  • ✅ 绝不会在响应中暴露异常内部实现信息

卖家与买家密钥:

  • 收款地址(接收地址): 冷钱包用于接收收益(与买家密钥分开!)

  • 买家密钥: 仅用于支付上游成本的热钱包(绝不用于接收)

  • 绝对不要在 Render 上设置 EVM_PRIVATE_KEY - 仅本地使用!

|## 🌐 部署

在线仪表盘: https://alpha-sentinel-mcp.vercel.app/ (即将推出)

快速部署到 Vercel

点击下方链接或按照 DEPLOYMENT.md 中的步骤操作:

Deploy with Vercel

手动部署

# Install Vercel CLI
npm install -g vercel

# Deploy dashboard
cd /home/keef/alpha-sentinel-mcp
vercel --prod

仪表盘将自动代理 API 调用到您的个人后端。

Render(API 服务)

通过 render.yaml 部署 - 自动配置:

  • Web 服务(端口 8403)

  • Redis 实例(自动配置)

  • 环境变量来自安全存储

  • 健康检查端点:/health

Docker

docker build -t alpha-sentinel-mcp .
docker run -p 8403:8403 \
  -e X402_PAY_TO_ADDRESS=$PAY_TO \
  -e EVM_PRIVATE_KEY=$BUYER_KEY \
  alpha-sentinel-mcp

🤝 Swarm 智能体集成

当 SWARM_ENABLED=true 时,Alpha Sentinel 可以:

  1. 侦察(Scout) 探索上游 x402 数据源

  2. 守卫(Warden) 强制实施每个 ledger/policy.json 的支出限额

  3. 财务(Treasurer) 支付上游数据费用(唯一的支出角色)

  4. 档案(Archivist) 组装付费集合产品

  5. 主权(Sovereign) 重新定价以达到目标 LTV:CAC ≥ 3.0

  6. 商户(Merchant) 列出生成的合成产品

集合示例:购买来自 3 个上游的原始价格 → 聚合 → 以 3 倍加价重新销售为“高级套装”!

📈 市场发现

在 CDP Bazaar 上展示:

  • 服务名称:Alpha Sentinel 市场情报平台

  • 标签:基础、智能、加密、市场、情绪

  • 所有权证明:使用接收地址签名

  • 产品列表 URL:https://alpha-sentinel-mcp.onrender.com/.well-known/x402

🎓 文档

🏆 成功指标

  • 警报延迟: 端到端 <30s

  • 结算成功率: >95% 首次尝试

  • LTV:CAC 比率: 目标 ≥ 3.0

  • 锁仓边际: 组合产品 ≥ 50%

  • 配额利用率: 超过 70% 的专业层级转化率

🎯 设立

由 Keith 构建 (kwizzlesurp10-ctrl)作为 AI Agency Factory 生态的一部分。灵感来源于 Karpathy 的 LLM Wiki 知识组织方式和 x402 微支付革命!

特别感谢:

  • Coinbase CDP 团队提供 x402 促进层

  • FastAPI + FastMCP 维护者们

  • 整个开源 x402 社区

📄 开源许可证

MIT - 允许商业使用,请注明来源! ★彡


准备好实现你的市场情报价值了吗?
👉 立即部署
👉 阅读用户指南
👉 查看仪表盘

(◕‿◕) ✨ 预测智能,由链上经济学提供动力! ♪

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides AI agents with real-time, structured data feeds including news, trends, market sentiment, and crypto prices via MCP tools.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible AI clients to access live crypto market data and AI-driven quantitative analysis, with structured outputs and full observability.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to access professional crypto market intelligence via 8 MCP tools, covering market regime, fear/greed, funding rates, DeFi yields, token signals, wallet risk, and contract audits. Backed by real-time data from Binance, DeFiLlama, Etherscan, with both free tools and x402 micropayment options.
      2
      MIT