内容
# coinopai-mcp
[](https://www.npmjs.com/package/coinopai-mcp)
[](https://www.npmjs.com/package/coinopai-mcp)
[](LICENSE)
[](https://nodejs.org)
[](https://x402.org)
[](https://base.org)
**可审计的市场环境，具有校准的预测范围和结果验证。**
**来源：** https://github.com/forgemeshlabs/coinopai-mcp
一个 MCP 服务器，允许 AI 代理使用 [x402](https://x402.org) 微支付在 Base 上购买 Kronos 市场环境。Kronos 不是一个买卖预言机：它为代理提供校准的范围、风险环境、决策日志和审计记录，他们可以验证。
> 该存储库是 MCP 客户端层；付费情报从托管的 CoinOpAI x402 端点提供。
> 弱调用和错误调用也会显示出来。这就是重点。
## 为什么 Kronos 与众不同
大多数市场 API 在返回方向后就停止了。Kronos 首先提供校准的范围和风险环境，然后分配一个 `decision_id`，以便每个决策都可以针对未来的市场行为进行审计。
护城河是审计循环：
```
预飞行 -> 决策 -> 审计
```
信任过程减少。验证记录增加。
---
## 架构
```
┌──────────────────────────────────┐
│ Claude 代码 / AI 代理 │
└──────────────┬───────────────────┘
│ MCP（stdio）
▼
┌──────────────────────────────────┐
│ coinopai-mcp │
│ npx coinopai-mcp │
└──────────────┬───────────────────┘
│ HTTP + 402 支付头
▼
┌──────────────────────────────────┐
│ x402.coinopai.com │
│ Kronos 智能 API │
└──────────────┬───────────────────┘
│
▼
┌──────────────────────────────────┐
│ Coinbase x402 促进者 │
│ USDC 在 Base 主网上结算 │
└──────────────────────────────────┘
```
代理调用一个工具 → MCP 服务器接收一个 `HTTP 402` → 自动签署一个 USDC 微支付 → 重试带有支付头 → 返回数据。配置一次，从配置的低余额钱包自动支付。
当前包：`coinopai-mcp@1.2.10`。
结算说明：MCP 固定 `@x402/core` 和 `@x402/evm` 为 `2.11.0`，并使用链感知时间戳签署 EIP-3009 授权。这避免了 Base RPC/促进者时钟偏移故障模式，其中支付可能被拒绝为“授权尚未生效”或“有效期之前已过期”。成功的对象响应包括 `_payment` 下的 x402 结算元数据，包括可用的链上交易哈希。
---
## 可审计的循环（$0.27/循环）
```
检查交易预飞行 ──→ 获取加密决策 ──→ [等待 1 小时] ──→ 审计交易决策
$0.05 $0.15 $0.07
市场状态？ 方向背景 结果记录
冷却背景？ 置信度背景 方向保持？
制度背景？ + 决策 ID 判决
数据新鲜度？ + 审计提示 + pnl_pct
```
每个决策都是自我验证的。`decision_id` 将设置链接到结果。审计获取实际市场价格并生成判决。没有任何隐藏的内容。
## 当前状态
**上线**
- 模型背景
- 风险评估
- 决策日志
- 结果验证
- 预测：一致校准的 80% 价格范围（~0.80 经验覆盖率）
**研究**
- 方向优势：反向测试中未证明（~51% 准确）- 校准范围是验证产品，而不是方向
- 预测 vs 执行协议分析：收集证据
校准的预测范围是上线和验证的（一致，~0.80 覆盖率）。方向值是支持背景，而不是独立的交易指令。将其与校准范围、风险状态和审计记录一起使用。
## 方向背景
| 值 | 含义 |
|--------|---------|
| 正面 | 看涨模型背景 |
| 负面 | 看跌模型背景 |
| 0.00-0.01 | 弱幅度 |
| 0.01-0.03 | 中等幅度 |
| 0.03+ | 强幅度 |
方向值是支持背景，而不是保证、人类建议或独立的交易指令。将其与校准范围、风险状态和审计记录一起使用。
---
## 实际输出
**步骤 1 — 预飞行（BTC，$0.05）**
```json
{
"allowed": true,
"symbol": "BTC/USD",
"market_state": "NORMAL",
"signal_strength": "weak_or_mixed",
"regime": "TREND",
"cooldown_remaining_seconds": 0
}
```
**步骤 2 — 决策（BTC，$0.15）**
```json
{
"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）**
```json
{
"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_signals` | BTC, ETH, SOL, XRP, ADA 的模型背景 | $0.05 | ✓ |
| `get_crypto_signal_history` | 分析最多 168 小时的背景历史 | $0.05 | ✓ |
| `get_crypto_forecast` | BTC, ETH, SOL, XRP, ADA 的一致校准 80% 价格范围（~0.80 经验覆盖率） | $0.05 | ✓ |
| `review_signal_anomaly` | 评估信号特征的异常情况；返回审查标签，驱动因素和组件分数 | $0.07 | — |
| `get_crypto_risk` | 市场风险状态和冷却背景 | $0.02 | — |
| `search_agent_automations` | 搜索 819 个代理自动化提示 | $0.01 | — |
| `get_agent_automation` | 通过 slug 获取完整提示 + 工作流程步骤 | $0.01 | — |
| `list_automation_categories` | 所有 35 个自动化类别及其计数 | $0.005 | — |
无 API 密钥。无订阅。按调用次数以 USDC 支付。
---
## 安装
### Claude 代码
添加到 `~/.claude/settings.json`:
```json
{
"mcpServers": {
"coinopai": {
"command": "npx",
"args": ["-y", "coinopai-mcp"],
"env": {
"WALLET_PRIVATE_KEY": "0x<your-base-wallet-private-key>"
}
}
}
}
```
重启 Claude 代码。工具将自动出现。
### Claude 桌面版
将以下内容添加到您的 Claude 桌面配置（`claude_desktop_config.json`）：
```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 可能会优先使用本地包上下文，并在临时二进制文件可用之前失败。从另一个目录进行测试，或安装到临时项目中并启动 `./node_modules/.bin/coinopai-mcp`。
### 注册状态
已准备的 MCP 注册身份：`io.github.forgemeshlabs/coinopai-mcp`。发布此包后刷新公共目录提交，以便旧的 `clawdbotworker` 条目停止成为规范。
---
## 获取钱包
1. 安装 [Coinbase 钱包](https://wallet.coinbase.com) 或任何 EVM 钱包
2. 切换到 **Base** 网络
3. 购买或桥接 USDC（$1 = ~3 个完整的验证循环）
4. 使用专用的低余额 Base 钱包进行代理支付，并通过环境变量提供其私钥。
> 您的钱包密钥保留在本地。 它永远不会离开您的机器。 每次支付都是签名的微支付 - 而不是 blanket 批准。
---
## 代理代码示例
```js
// 步骤 1 — 门槛检查（$0.05）
const pre = await mcp.call("check_trade_preflight", { symbol: "BTC" })
if (!pre.allowed) return // 冷却，坏制度或数据过时
// 步骤 2 — 获取决策日志（$0.15）
const dec = await mcp.call("get_crypto_decision", { symbol: "BTC" })
// 存储 decision_id - 您需要它来关闭循环
const { decision_id, directional_bias, confidence } = dec
// 可选 - 审查一组特征以获取异常上下文（$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"
// 步骤 3 — 1 小时后审计（$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` 字段 - 您的代理始终知道何时以及如何审计。
**符号不可用？** 如果某个符号在当前 Kronos 周期中不可用：
```json
{
"status": "UNAVAILABLE_THIS_CYCLE",
"available_symbols": ["BTC/USD", "ETH/USD", "XRP/USD"],
"retry_hint_seconds": 900
}
```
路由到可用符号或等待 15 分钟下一个周期。
---
## 支付栈
| 组件 | 值 |
|-----------|-------|
| 协议 | [x402](https://x402.org) |
| 方案 | ExactEvmScheme (EIP-3009 `transferWithAuthorization`) |
| 网络 | Base 主网 (`eip155:8453`) |
| 代币 | USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`) |
| 促进者 | Coinbase |
| 客户端 SDK 固定 | `@x402/core@2.11.0`, `@x402/evm@2.11.0` |
| 接收元数据 | 成功的对象响应包括 `_payment` |
---
## 合作伙伴归属（通过 Pyrimid）
高价值工具接受一个可选的 `affiliate_id` 参数。提供时，支付通过 [Pyrimid](https://pyrimid.xyz) 合作伙伴网络路由 - 合作伙伴从列出的价格中获得佣金分成。**对调用者无额外成本。**
### 分成工作原理
```
直接调用（无 affiliate_id）：
调用者支付 $0.15 → CoinOpAI 接收 $0.15
合作伙伴调用（存在 affiliate_id）：
调用者支付 $0.15 → CoinOpAI：79.2% ($0.1188)
→ 合作伙伴：19.8% ($0.0297)
→ 协议： 1.0% ($0.0015)
```
买家始终支付列出的价格。分成来自供应商的部分。
### 用法
在支持的工具调用中传递 `affiliate_id`：
```js
// 作为代理或用户
await mcp.call("get_crypto_decision", {
symbol: "BTC",
affiliate_id: "af_youraffiliateID"
})
```
### 构建包装器？一次在 env 中设置
如果您正在构建代理框架、MCP 包装器或自动化嵌入 CoinOpAI 工具，请将您的合作伙伴 ID 设置为环境变量。您的每个调用都通过包装器赚取佣金。
```json
{
"mcpServers": {
"coinopai": {
"command": "npx",
"args": ["-y", "coinopai-mcp"],
"env": {
"WALLET_PRIVATE_KEY": "0x<agent-wallet-key>",
"PYRIMID_AFFILIATE_ID": "af_<your-affiliate-id>"
}
}
}
}
```
工具级 `affiliate_id` 参数优先于环境变量。调用者可以始终覆盖。
### 无 affiliate_id
正常的 x402 流程 - CoinOpAI 接收列出的价格的 100%。对调用者来说没有任何变化。
---
## 免责声明
决策输出是用于实验自动化工作流的概率背景和日志条目。不是财务建议。方向偏差尚未被验证为独立的交易策略。结果将有所不同。永远不要冒您无法承受损失的资本风险。
---
## ForgeMesh 生态系统的一部分
用于货币化代理生态系统的基础设施。
| 包 | 功能 | 安装 |
|---------|------|---------|
| [affiliate-router-mcp](https://github.com/forgemeshlabs/affiliate-router-mcp) | 供应商中立的货币化路由 | `npm i affiliate-router-mcp` |
| **coinopai-mcp** | 付费加密情报（此包） | `npm i coinopai-mcp` |
| [forgemesh-imagegen](https://github.com/forgemeshlabs/imagegen-mcp) | 付费图像生成 MCP | `npm i forgemesh-imagegen` |
每个包都独立工作。无需共享依赖项。
---
## 许可证
MIT - 请参阅 [LICENSE](LICENSE)
