OnchainAI

OnchainAI

加密工具，统一汇集。通过网页或直接在 Agent 中发现、审核并安装 MCP、CLI、SDK、API、x402、RWA 和 AI Agent 工具。

在线访问：onchain-ai.xyz · 连接中心：onchain-ai.xyz/connect

为什么选择它？

加密工具分散在 CryptoSkill、Smithery、npm、GitHub 主题以及数十个独立注册表中，而且大多数都难以评估：这个 MCP 服务是官方的吗？安装命令安全吗？每次调用都会收取 x402 费用吗？

OnchainAI 会从多个来源自动发现工具，将其归类到统一的三轴分类体系（功能 × 资产类别 × 参与者），评估可信度与安装风险，并向人类（网页 UI）和 Agent（MCP 服务、插件、技能）提供所有信息——因此，“帮我找一个安全的工具，把 USDC 跨链桥接到 Base”只需问一句，不必花一个下午研究。

在 Agent 中使用（60 秒）

默认 MCP 是无需认证的目录端点（用于发现和查看元数据，不托管钱包）。公共 /mcp 提供免费发现功能（搜索、详情、比较、安装指南、类别等）。可选的 OnchainAI 自有高级工具可能返回 HTTP 402，并通过 x402 结算（export_toolkit / recommend_verified_tool / gap_audit 每次 $0.01 USDC；check_endpoint_health 每次约 $0.001 USDC）。浏览网站始终免费。

https://www.onchain-ai.xyz/mcp

仅限 OKX 市场集成方：付费套餐路径为 https://www.onchain-ai.xyz/mcp/okx（OKX 门控启用时，每次 tools/call 约收费 $0.1）。编码 Agent 和 Claude 插件必须使用 /mcp，而非 /mcp/okx。

客户端	设置
Claude Code	claude mcp add --transport http onchainai https://www.onchain-ai.xyz/mcp
Claude Desktop / Web	设置 → 连接器 → 添加自定义连接器 → 粘贴上方 URL
Cursor / VS Code	使用连接中心中的一键 deeplink，或粘贴下方 JSON
ChatGPT	设置 → 连接器（开发者模式）→ 使用上方 URL 创建新连接器
其他客户端	npx add-mcp https://www.onchain-ai.xyz/mcp，或供仅支持 stdio 的客户端使用 npx mcp-remote https://www.onchain-ai.xyz/mcp

{
  "mcpServers": {
    "onchainai": { "type": "http", "url": "https://www.onchain-ai.xyz/mcp" }
  }
}

各客户端的完整使用指南（Codex、Windsurf、Gemini CLI 等）：docs/CONNECT.md，或访问在线的 /connect 页面。

MCP 工具（公开的 POST /mcp）

工具	计费	功能
search_tools	免费	按功能搜索（“将 USDC 跨链桥接到 Base”），按类别／链筛选，并按相关性／信任度／星标数／近期程度排序
get_tool_detail	免费	单个工具的完整元数据：信任评分、安装风险、链、仓库、x402 定价
get_install_guide	免费	特定平台的安装步骤（claude / cursor / generic / cli），并设有安全门控——不提供风险为 critical 的命令
list_categories	免费	浏览分类体系及工具数量
get_dashboard_snapshot	免费	公开覆盖情况快照：总数、类别、信任度、x402、精选工具
compare_tools	免费	并排比较 2–4 个工具的信任度、风险、链和定价
get_price_history / get_x402_trends	免费	查询历史记录和目录中的 x402 趋势（元数据）
export_toolkit	$0.01 USDC	按 slug 或类别导出 JSON + Markdown 安装包
recommend_verified_tool	$0.01 USDC	根据意图挑选一个已验证／在线的工具，并说明不采用其他选项的原因
gap_audit	$0.01 USDC	分解意图并报告目录覆盖缺口
check_endpoint_health	~$0.001 USDC	对已列出的 x402 工具进行实时端点探测，并检查 30 天运行时间（HTTP 402 握手）

从编码 Agent 关联你的账号（/connect#agent-sync）后，可解锁另外三个工具 （关联账号 ≠ 付款）：save_to_toolkit、save_stack_to_blueprint 和 link_status。

完整混合表（含 /mcp/okx）：docs/CONNECT.md。

Claude Code 插件

一条命令即可配置 MCP 服务、/find-tool 命令和加密工具技能：

/plugin marketplace add Coinyak/onchainai
/plugin install onchainai@onchainai

插件包位于 plugin/onchainai/ — 它只连接 OnchainAI 自己的只读端点，不会自动运行安装命令，并且在推荐付费工具前始终披露 x402 定价。

Agent 技能

plugin/onchainai/skills/onchainai-crypto-tools/SKILL.md 会教 Agent 何时 搜索目录、如何评估信任信号，以及必须遵守的安全规则（绝不安装风险为 critical 的工具，始终明确说明 x402 费用）。 该技能随插件一起提供；你也可以将技能目录复制到 ~/.claude/skills/，或上传到任何支持 Agent Skills 的 Agent 运行环境。

功能

• 自动发现爬虫 — 通过 CryptoSkill、GitHub topics、npm、web3-mcp-hub、MCP registry 进行发现，按 cron 计划运行，并执行去重和相关性评分
• 三轴分类 — 功能 × 资产类别 × 参与方，并添加链标签
• 信任与安全流程 — 信任评分、身份集群检查（仓库／npm／主页）、安装风险分析（硬性拦截 critical 命令）、运营者审核队列、隔离
• x402 感知 — 付费工具带有价格元数据、验证标记和推荐／归因披露（下方政策）
• 面向 Agent 的 MCP 服务 — 提供上述只读工具，并进行速率限制和数据清理
• Claude Code 插件 + 技能 — 为 Agent 用户提供一键接入
• 身份验证 — GitHub OAuth（主要方式）；在已配置的情况下支持电子邮件魔法链接
• 社区层 — 提交、评论、点赞、书签、工具包、比较、蓝图
• 管理控制面板 — 工具审核、类别、爬虫控制、精选轮播、用户、站点设置

x402 与推荐政策

OnchainAI 是一个工具目录 MCP（发现/元数据），而非托管钱包：

• 目录中的第三方 x402仅作为归属和信任元数据——我们会发布价格/端点标记（payment_verified、x402_endpoint_verified、price_verified），但绝不会代理这些付款。
• 我们会记录匿名推荐/归属事件（浏览、安装指南获取），以支持与工具所有者达成的收入分成协议。
• 我们绝不持有用户资金、充当第三方支付网关，或臆造未记录的 referrer/split 付款字段。
• OnchainAI 自有高级 MCP 工具（export_toolkit、recommend_verified_tool、gap_audit、check_endpoint_health）在调用时可能会通过 x402 向我们的收款钱包结算——这是在销售我们自己的服务，而非托管他人的资金。
• 未经验证的第三方 x402 工具只要通过常规公开质量门槛，就仍会显示——验证徽章用于标示状态，而非用于隐藏工具。

详情：docs/X402_REFERRAL_SPEC.md，混合连接：docs/CONNECT.md。

架构

┌─ Vercel ──────────────┐      ┌─ Railway ─────────────────────────┐
│ Next.js frontend      │──────│ Rust binary (Axum)                │
│ /connect, /tools, ... │ /api │  ├─ REST API (/api/v2)            │
│ proxies /api /auth    │ /mcp │  ├─ MCP server (POST /mcp)        │
│ /mcp to the API       │      │  ├─ Auth (GitHub OAuth + JWT)     │
└───────────────────────┘      │  └─ Crawler (tokio-cron)          │
                               └────────────┬──────────────────────┘
                                            │ sqlx
                               ┌─ Supabase Postgres (RLS) ─┐
                               └───────────────────────────┘

• API/MCP：Rust — Axum + sqlx + tokio-cron-scheduler，单个二进制文件（cargo run --features ssr）
• 前端：Vercel 上的 Next.js（App Router），将 /api、/auth、/mcp 重写到 Railway API
• 数据库：带 RLS 的 Supabase Postgres；公开读取门槛通过 SQL 策略和服务端查询共同实施

自行运行

git clone https://github.com/Coinyak/onchainai
cd onchainai
cp .env.example .env        # fill in Supabase URL/keys, GitHub OAuth, JWT secret

# API (port 3000)
cargo run --features ssr

# Frontend (port 3001, proxying to the API)
cd frontend && npm ci && API_PROXY_TARGET=http://localhost:3000 npm run dev -- --port 3001

Crate 的默认功能集为空，因此服务端依赖不会泄漏到任何 WASM/客户端构建中。涉及服务端代码的普通 cargo 命令需要 --features ssr。

常见检查：

cargo test --features ssr                      # tests
cargo clippy --features ssr -- -W clippy::all  # lint
cargo fmt --check                              # format
./scripts/agent-harness-check.sh               # agent/dev harness self-check

仓库结构

路径	内容
src/	Rust API：MCP 服务、REST /api/v2、身份验证、爬虫、信任/风险流程
frontend/	Next.js 应用（Vercel）：公开界面 + 管理仪表板
plugin/onchainai/	Claude Code 插件包（MCP 配置、/find-tool、技能）
migrations/	sqlx Postgres 迁移（包含 RLS 策略）
docs/	设计文档、规范、运维指南（索引）
scripts/	开发/部署/验证门槛（参见 AGENTS.md）
agent/、.agents/	在此仓库中工作的 AI 编码 Agent 所需技能和运行框架配置

文档

文件	用途
docs/CONNECT.md	连接任意 MCP 客户端，安装插件/技能
docs/MVP_DESIGN.md	架构、数据库架构、爬虫、MCP 服务
docs/X402_REFERRAL_SPEC.md	x402 推荐/归属设计（非托管）
docs/LAUNCH_READINESS_SPEC.md	公开发布检查清单和路线图规范
docs/SECURITY.md	安全设计：身份验证、RLS、标头、速率限制
docs/UI_UX_DESIGN.md	完整的 UI 规范
docs/OPERATOR_GUIDE.md	运维人员/管理员操作手册（韩语）
docs/BUILD_DEPLOY_RULES.md	构建一致性、冒烟测试门槛、Railway/Vercel 部署
AGENTS.md	AI 编码 Agent 入门文档

贡献与安全

• 欢迎贡献——请参阅 CONTRIBUTING.md。最快的帮助方式是在 onchain-ai.xyz/submit 提交缺失的工具。
• 安全报告：请参阅 SECURITY.md。请勿公开提交漏洞相关议题。

许可证

MIT