Easy Predict

Name: Easy Predict
Author: WilliamsRizzi

本地服务

github.com/WilliamsRizzi数据与分析018 周前更新

代码仓库

关于 Easy Predict

Easy Predict 是用于预测数值序列下一项并检测异常值的 API，面向需要基础时间序列分析的 Agent 和应用。调用通过 x402 在 Base 上以 USDC 按次付费。

主要功能

01预测序列下一项
02依据留出误差选择模型
03使用 Z-score 检测异常
04在响应中回传可选上下文
05通过 Base 上的 USDC 按次付费

适用场景

01预测数值序列
02查找测量值中的异常点

MCP 相关

本地 MCP 服务向 MCP 客户端提供预测和异常检测工具。它在设备上签署 x402 付款，并将签名后的付款标头发送至 API。

#prediction #anomaly-detection #time-series #x402 #usdc #base #machine-learning #forecasting

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "easy-predict": {
      "command": "uvx",
      "args": [
        "easy-predict-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}

启动命令uvx easy-predict-mcp

需要配置的环境变量

WALLET_PRIVATE_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypieasy-predict-mcpstdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
context	string	否
series	array	是

详细介绍

easy-predict

面向 Agent 的预测和异常检测 API。发送一组数字，即可获取下一个预测值或异常点列表。通过 x402 v2 微支付按次付费——在 Base 上每次收费 0.01 美元 USDC。无需 API 密钥，无需账户。

已上线：easy-predict.com

端点

方法	路径	费用	说明
POST	`/timeseries`	0.01 美元 USDC	预测数值序列中的下一个值
POST	`/anomaly-detection`	0.01 美元 USDC	通过 z-score 检测异常
GET	`/.well-known/x402`	免费	x402 v2 资源发现
GET	`/openapi.json`	免费	OpenAPI 3.1 规范
GET	`/llms.txt`	免费	面向人类和 Agent 的 API 文档

POST /timeseries

curl https://easy-predict.com/timeseries \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <signed-x402-payload>" \
  -d '{"series": [1.0, 2.3, 4.1, 6.8, 9.2], "context": "monthly revenue USD"}'

响应：

{
  "prediction": 12.1,
  "method": "linear",
  "holdout_errors": {"linear": 0.05, "log1p-linear": 0.31, "last-delta": 0.05, "mean": 3.5},
  "slope": 1.94,
  "intercept": 0.12
}

模型选择：留出最后一个点，使用 linear、log1p-linear、last-delta 和 mean 对其进行评估，然后在完整序列上重新训练表现最佳的模型。

POST /anomaly-detection

curl https://easy-predict.com/anomaly-detection \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <signed-x402-payload>" \
  -d '{"series": [1.0, 2.3, 4.1, 6.8, 99.0], "threshold": 2.0}'

响应：

{
  "anomalies": [{"index": 4, "value": 99.0, "z_score": 2.14}],
  "method": "z-score",
  "mean": 15.12,
  "std": 39.18,
  "threshold": 2.0
}

两个端点都接受可选的 "context" 字符串（最多 200 个字符），并会在响应中原样返回。

x402 付款流程

省略付款标头即可获取包含完整付款条款的 402 响应：

{
  "x402Version": 2,
  "error": "Payment Required",
  "accepts": [{
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0xc99b83818c8865340AC55C45554f377f41c68DBC",
    "maxTimeoutSeconds": 60
  }]
}

解析 402 响应中的 accepts[0]
使用你的钱包签署付款载荷
将签名后的 JSON 进行 Base64 编码，并使用 PAYMENT-SIGNATURE: <encoded> 重试
Cloudflare Worker 通过 https://x402.org/facilitator 验证并在链上结算

付款：10000 个原子单位 = 在 Base 主网上支付 0.01 美元 USDC（6 位小数）。

MCP 服务（Claude Desktop、Cursor、Windsurf）

MCP 服务在你的计算机本地运行。你的钱包私钥不会离开设备——它会在本地签署 x402 付款，且只会向 easy-predict.com 发送签名后的标头。

在 MCP 客户端配置中添加：

{
  "mcpServers": {
    "easy-predict": {
      "command": "uvx",
      "args": ["easy-predict-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0xYOUR_WALLET_PRIVATE_KEY"
      }
    }
  }
}

然后向 Claude 提问：“预测这个序列的下一个值：1.2、2.4、4.1、6.8”——它会调用工具，自动从你的钱包支付 0.01 美元 USDC，并返回预测结果。

已在 Smithery 上架——搜索 easy-predict 即可一键安装。

Agent 集成（Python）

一个可运行的 Claude Agent，可自主处理完整的 402 → 签名 → 重试流程：

pip install anthropic requests eth-account
ANTHROPIC_API_KEY=sk-... WALLET_PRIVATE_KEY=0x... python examples/demo_agent.py

examples/demo_agent.py — 使用 Anthropic 工具调用。同样的模式也适用于 LangChain、LlamaIndex、CrewAI 或 AutoGen。

演示模式（无需钱包，连接本地服务）：

cd timeseries && python app.py &
ANTHROPIC_API_KEY=sk-... python examples/demo_agent.py

架构

Cloudflare Worker（src/index.ts）— 边缘运行时、速率限制，以及通过 facilitator 完整执行 x402 验证和结算
Flask 后端（timeseries/app.py）— Python 预测逻辑、本地开发服务
静态资源（public/）— 欢迎页、openapi.json、llms.txt

Worker 处理所有生产流量。Flask 应用用于本地开发，运行在 8000 端口。

本地开发

pip install -r requirements.txt
cd timeseries && python app.py        # Flask on http://localhost:8000

本地 Flask 服务只检查付款标头是否存在——任何非空的 PAYMENT-SIGNATURE 标头都会被接受。适合在没有真实钱包的情况下进行测试。

Cloudflare Worker 的运行方式：

npm install
npx wrangler dev                      # Worker on http://localhost:8787

仓库结构

timeseries/app.py                        Flask backend (prediction + anomaly detection logic)
anomaly_detection/app.py                 Anomaly detection blueprint
src/index.ts                             Cloudflare Worker (edge runtime)
mcp_server/easy_predict_mcp/server.py   MCP server — runs locally, signs payments on device
mcp_server/pyproject.toml               PyPI package definition (easy-predict-mcp)
smithery.yaml                            Smithery registry config
public/
  index.html                             Splash page
  openapi.json                           OpenAPI 3.1 spec
  llms.txt                               Human/agent-readable docs
examples/
  demo_agent.py                          Claude agent integration demo with x402 payments
tests/                                   Test suite

配置

Flask 后端环境变量（均为可选）：

变量	默认值	说明
`PAY_TO_ADDRESS`	`0xc99b...`	收款钱包
`X402_ASSET`	Base 上的 USDC	ERC-20 资产地址
`X402_NETWORK`	`eip155:8453`	链 ID
`X402_MAX_AMOUNT`	`10000`	原子单位（0.01 美元）
`FACILITATOR_URL`	`https://x402.org/facilitator`	x402 facilitator
`PUBLIC_BASE_URL`	`https://easy-predict.com`	402 响应中资源 URL 的基础 URL