mcpField
C
coinopai-mcp

coinopai-mcp

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

关于 coinopai-mcp

coinopai-mcp 是面向 Kronos 加密市场情报的 MCP 客户端层，通过 Base 上的 x402 USDC 微支付按次付费。它提供校准后的预测区间、风险背景、决策日志和结果审计，而非独立交易指令。

主要功能

  1. 01预先检查市场状态与风险
  2. 02获取加密市场背景、信号和校准区间
  3. 03记录带 ID 的决策以供后续审计
  4. 04将决策与真实价格及结果对照
  5. 05通过 x402 USDC 微支付按次付费

适用场景

  1. 01在作出加密资产决策前查看风险和市场背景
  2. 02记录决策，并在评估窗口后审计
  3. 03检查期货资金费率、清算距离和风险
  4. 04搜索 Agent 自动化提示词与工作流

MCP 相关

MCP 服务公开由托管 x402 端点支持的 CoinOpAI 付费工具。遇到 HTTP 402 时，它会在 Base 上签署 USDC 微支付并重试请求；钱包密钥保留在本地。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "forgemeshlabs-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-mcp2.2.2

工具

还没有获取到工具列表

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

详细介绍

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 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。