mcpField
C
coinopai-mcp

coinopai-mcp

本地服务
github.com/forgemeshlabs金融数据13 周前更新
代码仓库

关于 coinopai-mcp

coinopai-mcp 是面向 AI Agent 的加密市场情报 MCP 客户端层，提供校准价格区间、风险背景和可审计的决策记录，而非买卖指令。它通过 x402 在 Base 上以 USDC 按次购买托管端点的数据。

主要功能

  1. 01检查交易前置条件与市场状态
  2. 02获取加密市场信号和风险背景
  3. 03生成校准价格区间与决策记录
  4. 04依据真实价格审计决策结果
  5. 05查询永续合约资金费率与风险
  6. 06搜索 819 条 Agent 自动化提示词

适用场景

  1. 01在自动化交易前检查市场条件
  2. 02为加密资产分析参考价格区间和风险
  3. 03记录决策并在后续核验结果
  4. 04检索 Agent 自动化提示词与工作流

MCP 相关

通过 MCP 向 AI Agent 提供 Kronos 市场情报工具；付费数据由托管的 CoinOpAI x402 端点提供。客户端在 Base 上使用 USDC 自动按次付款。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "clawdbotworker-coinopai": {
      "command": "npx",
      "args": [
        "-y",
        "coinopai-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
启动命令npx -y coinopai-mcp
需要配置的环境变量
WALLET_PRIVATE_KEY密钥Dedicated low-balance Base wallet private key for x402 USDC micropayments. Do not use your primary wallet.

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

安装包
npmcoinopai-mcp1.2.4

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

coinopai-mcp

M8ven Verified

npm version npm downloads License: MIT Node.js payments network mcpservers.org

可审计的市场背景信息，提供经过校准的预测区间和结果验证。

源代码： https://github.com/forgemeshlabs/coinopai-mcp

一个 MCP 服务，让 AI Agent 能够通过 x402 在 Base 上进行微支付，购买 Kronos 市场背景信息。Kronos 并非买入／卖出预言机：它为 Agent 提供经过校准的区间、风险背景、决策日志和可供验证的审计记录。

此仓库是 MCP 客户端层；付费智能信息由托管的 CoinOpAI x402 端点提供。

错误的调用和错误的判断也会展示出来。这正是重点。

Kronos 有何不同

大多数市场 API 返回方向后便止步不前。Kronos 首先提供经过校准的区间和风险背景，然后分配一个 decision_id，以便根据未来的市场表现审计每项决策。

核心优势在于审计闭环：

preflight -> decision -> audit

少相信流程，多核验记录。

架构

┌──────────────────────────────────┐
│   Claude Code / AI Agent         │
└──────────────┬───────────────────┘
               │  MCP (stdio)
               ▼
┌──────────────────────────────────┐
│        coinopai-mcp              │
│    npx coinopai-mcp              │
└──────────────┬───────────────────┘
               │  HTTP + 402 payment header
               ▼
┌──────────────────────────────────┐
│      x402.coinopai.com           │
│   Kronos intelligence API        │
└──────────────┬───────────────────┘
               │
               ▼
┌──────────────────────────────────┐
│   Coinbase x402 Facilitator      │
│   USDC settled on Base mainnet   │
└──────────────────────────────────┘

Agent 调用工具 → MCP 服务收到 HTTP 402 → 自动签署 USDC 微支付 → 携带支付标头重试 → 返回数据。只需配置一次，即可从已配置的低余额钱包自动付款。

当前软件包：[email protected]。

结算说明：MCP 将 @x402/core 和 @x402/evm 固定为 2.11.0。成功的对象响应会在 _payment 下包含 x402 结算元数据，其中包括链上交易哈希（如果可用）。

可审计闭环（每个周期 $0.27）

check_trade_preflight  ──→  get_crypto_decision  ──→  [wait 1h]  ──→  audit_trade_decision
       $0.05                      $0.15                                      $0.07

   Market state?             Directional context              Outcome record
   Cooldown context?         Confidence context               Direction held?
   Regime context?           + decision_id                    Verdict
   Data freshness?           + audit hint                     + pnl_pct

每项决策都可以自行验证。decision_id 将初始设置与结果关联起来。审计会获取真实市场价格并给出判定。没有任何内容被隐藏。

当前状态

已上线

  • 模型背景信息
  • 风险评估
  • 决策日志
  • 结果验证
  • 预测：经过保形校准的 80% 价格区间（经验覆盖率约为 0.80）

研究中

  • 方向性优势：回测尚未证明存在（准确率约为 51%）——经过校准的区间才是已验证的产品，而非方向预测
  • 预测与执行的一致性分析：正在收集证据

经过校准的预测区间已上线并通过验证（保形校准，覆盖率约为 0.80）。方向性数值仅作辅助背景信息，并非独立的交易指令。请结合经过校准的区间、风险状态和审计记录使用。

方向性背景信息

数值含义
正值看涨的模型背景信息
负值看跌的模型背景信息
0.00-0.01幅度较弱
0.01-0.03幅度中等
0.03+幅度较强

方向性数值仅作辅助背景信息，并非保证、对人的建议或独立的交易指令。请结合经过校准的区间、风险状态和审计记录使用。

实际输出

步骤 1 — 预检（BTC，$0.05）

{
  "allowed": true,
  "symbol": "BTC/USD",
  "market_state": "NORMAL",
  "signal_strength": "weak_or_mixed",
  "regime": "TREND",
  "cooldown_remaining_seconds": 0
}

步骤 2 — 决策（BTC，$0.15）

{
  "symbol": "BTC/USD",
  "directional_bias": "upward",
  "confidence": 0.514,
  "compliance_mode": "market_intelligence_only",
  "regime": "TREND",
  "decision_id": "a3f8c1d2-9472-4dfe-b459-5df17b282614",
  "directional_edge": "none_demonstrated",
  "why_not_high": [
    "Directional confidence is capped by observed historical accuracy, not boosted by signal magnitude."
  ],
  "next_step": "Call audit_trade_decision with this decision_id after 1h using window=1h"
}

步骤 3 — 审计（1 小时后，$0.07）

{
  "decision_id": "a3f8c1d2-9472-4dfe-b459-5df17b282614",
  "direction_held": true,
  "pnl_pct": 0.82,
  "verdict": "GOOD_DECISION"
}

审计判定包括 GOOD_DECISION、BAD_DIRECTION、NOISE、NO_ACTION_TAKEN 和 PENDING。Kronos 有时判断正确，有时判断错误，并通过同一条记录呈现两者。

新的审计在评估窗口成熟前可能会返回 pending_window。

工具

工具功能费用
check_trade_preflight门控检查：市场是否允许、冷却时间、市场状态、模型上下文$0.05
get_crypto_decision概率决策日志 + decision_id$0.15
audit_trade_decision根据实时价格验证：结论 + PnL%$0.07
get_crypto_signalsBTC、ETH、SOL、XRP、ADA 的模型上下文$0.05
get_crypto_signal_history最多 168h 的上下文历史记录，用于分析$0.05
get_crypto_forecastBTC、ETH、SOL、XRP、ADA 的符合校准的 80% 价格区间（~0.80 经验覆盖率）$0.05
get_perp_funding期货。 实时永续合约资金费率、标记价格/指数价格、未平仓量、拥挤度（Kraken Futures + Hyperliquid）$0.02
check_futures_risk期货。 该方向 / 杠杆 / 入场价能否在校准区间内维持？清算距离 + 结论$0.05
get_futures_decision期货。 根据校准区间给出 LONG / SHORT / FLAT，并提供止损和目标价、杠杆上限、清算、仓位规模、资金费成本$0.15
review_signal_anomaly对信号特征进行评分，识别异常情况；返回审核标签、驱动因素和各项评分$0.07
get_crypto_risk市场风险状态和冷却时间上下文$0.02
search_agent_automations搜索 819 个 Agent 自动化提示词$0.01
get_agent_automation根据 slug 获取完整提示词 + 工作流步骤$0.01
list_automation_categories全部 35 个自动化类别及其数量$0.005

无需 API 密钥。无需订阅。使用 USDC 按次付费。

安装

Claude Code

添加到 ~/.claude/settings.json：

{
  "mcpServers": {
    "coinopai": {
      "command": "npx",
      "args": ["-y", "coinopai-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x<your-base-wallet-private-key>"
      }
    }
  }
}

重启 Claude Code。工具将自动显示。

Claude Desktop

添加到 Claude Desktop 配置文件（claude_desktop_config.json）：

{
  "mcpServers": {
    "coinopai": {
      "command": "npx",
      "args": ["-y", "coinopai-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x<your-base-wallet-private-key>"
      }
    }
  }
}
Smithery

目前尚未在 Smithery 上架。在公开列表通过验证并上线之前，请使用上文所示的 npx 安装流程。

开发者冒烟测试说明

使用 MCP stdio 测试工具测试已发布的软件包时，请勿在 coinopai-mcp 源码检出目录中运行 npx coinopai-mcp@...。npm 可能会优先使用本地软件包上下文，导致临时 bin 可用之前就失败。请从其他目录进行测试，或安装到临时项目中，再运行 ./node_modules/.bin/coinopai-mcp。

注册表状态

已准备好 MCP Registry 标识：io.github.forgemeshlabs/coinopai-mcp。发布此软件包后，请更新公开目录提交，以免旧的 clawdbotworker 条目继续作为规范条目。

获取钱包

  1. 安装 Coinbase Wallet 或任意 EVM 钱包
  2. 切换到 Base 网络
  3. 购买或跨链转入 USDC（$1 ≈ 3 次完整验证周期）
  4. 使用专用的低余额 Base 钱包支付 Agent 费用，并通过环境变量在本地提供其私钥。

付款保护措施。 服务仅会在 Base 主网上，以 USDC 向 CoinOpAI 收款钱包签名付款，每次调用金额不超过 $0.15，每个会话金额不超过 $10。签名前，服务会拒绝任何其他收款方、网络、资产或金额。环境变量 X402_MAX_PRICE_USD 和 X402_SESSION_BUDGET_USD 只能调低这些上限。服务仅与 https://x402.coinopai.com 通信（不跟随重定向，超时为 60s，响应上限为 2 MB）。请使用专用的低余额钱包。

你的钱包密钥会保留在本地，绝不会离开你的设备。每笔付款都是经过签名的微支付，而非一揽子授权。

Agent 代码示例

// Step 1 — gate check ($0.05)
const pre = await mcp.call("check_trade_preflight", { symbol: "BTC" })
if (!pre.allowed) return  // cooldown, bad regime, or stale data

// Step 2 — get decision journal ($0.15)
const dec = await mcp.call("get_crypto_decision", { symbol: "BTC" })

// Store the decision_id — you'll need it to close the loop
const { decision_id, directional_bias, confidence } = dec

// Optional — review a feature set for anomaly context ($0.07)
const anomaly = await mcp.call("review_signal_anomaly", {
  symbol: "BTC",
  window: "24h",
  features: {
    price_change: 0.018,
    volume_change: 0.42,
    volatility: 0.031,
    signal_confidence: 72,
    risk_score: 31
  }
})
// review_label: "normal_review" | "review" | "elevated_review" | "critical_review"

// Step 3 — audit 1 hour later ($0.07)
const audit = await mcp.call("audit_trade_decision", {
  decision_id,
  window: "1h"
})
// verdict: "GOOD_DECISION" | "BAD_DIRECTION" | "NOISE"
console.log(audit.verdict, audit.pnl_pct + "%")

每个决策响应都包含 next_step 字段，确保你的 Agent 始终知道何时以及如何进行审核。

币种不可用？ 如果某个币种不在当前 Kronos 周期中：

{
  "status": "UNAVAILABLE_THIS_CYCLE",
  "available_symbols": ["BTC/USD", "ETH/USD", "XRP/USD"],
  "retry_hint_seconds": 900
}

改用可用币种，或等待 15 分钟，进入下一个周期。

Payment Stack

ComponentValue
协议x402
方案ExactEvmScheme（EIP-3009 transferWithAuthorization）
网络Base 主网（eip155:8453）
代币USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
FacilitatorCoinbase
客户端 SDK 固定版本@x402/[email protected]、@x402/[email protected]
收据元数据成功的对象响应包含 _payment

赞助卡片（Lulu Ads）

免费层级的工具响应可能包含一张来自 Lulu Ads 的已披露赞助卡片。它是 JSON 结果中的普通、带标签的数据字段，绝不会是模型可能读作指令的文本：

{
  "results": [...],
  "sponsored": { "label": "Sponsored", "text": "...", "url": "https://..." }
}
  • 符合条件的工具： search_agent_automations、list_automation_categories、get_agent_automation、check_trade_preflight——且仅限响应未结算 x402 付款（没有 _payment 收据）的情况。付费响应绝不会携带卡片。
  • 当前状态： 目前有一个免费工具——list_tools（直接获取 /menu，无需钱包或付款）——因此今天只有该工具会显示卡片。其他四个列入允许列表的工具仍为付费工具，因此不会附带卡片；开关位于服务端：当运营方将其中某个端点设为免费（返回不带 402 的普通 200）时，无需更改客户端，卡片便会开始显示。
  • 付费工具绝不携带卡片： get_crypto_signals、get_crypto_risk、get_crypto_signal_history、get_crypto_decision、audit_trade_decision、get_crypto_forecast、review_signal_anomaly、get_futures_decision、get_perp_funding、check_futures_risk 不会接触广告 SDK。
  • 移除卡片： delete result.sponsored。
  • 卡片来源： ForgeMesh 自己的发布方卡片由服务端附加到 GET https://x402.coinopai.com/menu，因此 list_tools 只需将其原样传递——此软件包不提供广告凭据，也不会自行调用广告网络。
  • 运营方环境变量（仅限分支）： LULU_ADS_PUBLISHER_ID 和 LULU_ADS_API_KEY 可让分支在客户端附加自己的发布方卡片（两者均为必填；缺少任意一个时，软件包不会调用广告网络，响应也不会改变）。LULU_ADS_ENABLED=false 是紧急关闭开关。
  • 失败时放行： 任何 SDK 错误或超时（硬性时限为 2 秒）都会返回原始响应，不作更改。唯一联系的外部主机是 ads.getlulu.dev。

免责声明

决策输出是概率性上下文和日志条目，仅用于实验性自动化工作流。不构成财务建议。方向性偏差尚未被验证为独立交易策略。结果可能有所不同。切勿投入无法承受损失的资金。

ForgeMesh 生态系统的一部分

为可变现的 Agent 生态系统提供基础设施。

PackageWhatInstall
affiliate-router-mcp与供应商无关的变现路由npm i affiliate-router-mcp
coinopai-mcp付费加密货币智能服务（本软件包）npm i coinopai-mcp
forgemesh-imagegen付费图像生成 MCPnpm i forgemesh-imagegen

每个软件包都可独立运行。无需共享依赖项。

许可证

MIT — 请参阅 LICENSE

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。