内容
align="center">
<img src="public/brand/onchainai-logo.png" alt="OnchainAI logo"" />
</p>
# OnchainAI
> 统一的加密货币工具。发现、验证和安装 MCP、CLI、SDK、x402、RWA 和 AI 代理工具 — 直接或您的代理。
[](LICENSE)
[](https://github.com/tokio-rs/axum)
[](https://nextjs.org)
[](https://www.onchain-ai.xyz/connect)
[](www.onchain-ai.xyz)
**在线访问：[onchain](https://www.onchain-ai.xyz)** · **连接[onchain-ai.xyz/connect](https://www.onchain-ai)**
## 为什么？
分散在 CryptoSkill、Smithery、npm、GitHub 主十个独立的 — 而且大多数工具都很难评估：这个 MCP 服务器？安装命令是否安全每次调用都收取 x402 费用？
OnchainAI 自动从多个来源发现工具，将它们标准化为一个三轴分类功能 × 资产类别 ×者），对信任度和安装评分，并将所有给人类（网页界面）和代理（MCP 服务器、插件、技能）— 因此，“为我找到一个安全的工具来桥接 USDC 到 Base”是一个问题，而不是一个下午的研究。
## 从您的代理使用（60 秒）
OnchainAI MCP 服务器是一个无身份验证的端点。所有发现工具都是免费且的；一个例外是_endpoint_health`，级信任工具，按费 x402：
```
https://www.on.xyz/mcp| 客户端 | 设置---|
| **Claude Code** | `claude add --transport http onchainai https://www.onchain-aicp` |
| ** Desktop / Web** | 连接器 → 添加自定义 → 粘贴上面的| **Cursor / VS Code** | 在 [连接中心](www.onchain-ai.xyz/connect) 上单击深度链接，或下面的 JSON |
| **ChatGPT** | 设置 → 连接器（开发者模式）→ 使用 创建新的连接器 |
|** | `npx add-mcp https://www.onchaincp`，npx mcp-://www.onchain-aicp` 用于仅限 的客户端 |
```json
{
"mcpServers": {
"onchainai": { "type": "http", "url": "https://chain-ai.xyz/mcp" }
}
}
```
完整的客户端逐步指南（Codex、WindsGemini CLI、…）：[docs/CONNECTdocs/CONNECT.md实时 [/connect](https.onchain-ai.xyz/connect) 页面。
### MCP 工具
工具 | 功能 |
|| `search_tools` |搜索（“桥接 USDC 到 Base”），/链过滤，按相关性/信任度/星级/最近程度排序 |
| `get_tool_detail` | 获取一个工具的完整元数据：信任度风险、链、仓库402 定价 |
| `get_install_guide` | 平台特定的安装步骤（claude / cursor / generic / cli），带有安全门控 — `critical` 风险命令被抑制 |
|_categories` | 浏览分类法并显示工具数量 |
get_dashboard_snapshot` | 公共覆盖快照：总数、类别、信任度、x精选 |
| `compare_tools 2-4 个工具的并排比较，比较、风险、链、定价（今天免费；操作员可以启用 x402 高级功能） |
| `export_toolkit` | 按 slug 或类别导出 JSON + markdown 安装工具包（今天免费；操作员可以启用 x402 高级功能） |
| `check_endpoint_health` | 端点活跃度 + 30 天运行时间，用于列402 工具 — 按调用付费 x402（HTTP 402 握手从编码代理链接您的/connect#agent-sync解锁另外三个：`_toolkit`、`save_blueprint` 和 `link_status`。
### Claude Code 插件
一个命令连接 MCP一个 `/find-tool`加密货币工具技能：
marketplace add Coinyak/onchainai
/plugin install onchainai@onchainai
```
位于 [`plugin/onchainai/`](plugin/onchainai/) — 它只连接 OnchainAI 自己的只读端点，从不自动运行安装命令，并且在推荐付费工具之前始终会披露 x402 定价 代理技能
[`chainai/skills/onchainai-crypto-tools/SKILL.md`](plugin/onchainai/skills/onchainai-crypto-tools/SKILL.md) 教导代理何时搜索目录信任信号，以及硬安全规则不安装 `critical` 风险工具，始终显示 x402 成本）。它与插件一起提供；您也可以将技能目录复制到 `~/.claude/skills/` 或上传到任何支持代理技能的代理运行时。
## 功能
- **自动发现爬虫** — CryptoSkill、GitHub 主题、npm、web3-mcp-hub、MCP 注册表，定时任务计划，具有重复数据删除和相关性评分
- **三轴分类** — 功能 × 资产类别 × 参与者，加上链标签
- **信任和安全管道** — 信任度评分、身份集群检查（仓库/npm/主页）、安装风险分析，带有 `critical` 命令的硬阻止，操作员审查队列，隔离区
- **x402 意识** — 付费工具带有价格元数据、验证标志和推荐/归属披露（[政策如下](#x402--referral-policy)）
- **代理的 MCP 服务器** — 上述只读工具，限速和净化
- **Claude Code 插件 + 技能** — 代理用户的一键式开通
- **三重身份验证** — GitHub OAuth + 电子邮件神奇链接 + SIWX 钱包签名（CAIP-122）
- **社区层** — 提交、评论、投票、书签、工具包、比较、蓝图
- **管理员仪表盘** — 工具审查、类别、爬虫控制、精选轮播、用户、站点设置
## x推荐政策
OnchainAI 仅限于**归属和信任元数据**：
- 我们发布 x402 价格/端点元数据和验证标志（`payment_verified`、`x402_endpoint_verified`、`price_verified`）作为信任信号。
- 我们记录匿名推荐/事件（视图、安装指南获取）以支持与工具所有者的收入分享协议。
- 我们**从不**持有或转移资金、代理支付、充当 x402 促进者/网关或发明未文档化的 `referrer`/`split` 支付字段。
- 未验证的 x402 工具在通过公共质量门槛时仍然可见；验证是一种徽章，而不是隐藏机制。
详情：[docs/X402_REFERRAL_SPEC.md](docs/X402_REFERRAL_SPEC.md)。
## 架构
```
┌─ Vercel ──────────────┐ ┌─ Railway ─────────────────────────┐
│ Next.js 前 │──────│ Rust 二进制文件（Axum） │
│ /connect, /tools, ... │ /api │ ├─ REST API (/api/v2) │
│ 代理 /api /auth │ /mcp │ ├─ MCP 服务器（POST /mcp） │
│ /mcp 到 API │ │ ├─ 身份验证（OAuth/电子邮件/SIWX + JWT） │
└───────────────────────┘ │ └─ 爬虫（tokio-cron） │
└────────────┬──────────────────────┘
│ sqlx
┌─ Supabase Postgres (RLS) ─┐
└───────────────────────────┘
```
- **API/MCP**：Rust — Axum + sqlx + tokio-cron-scheduler，一个二进制文件（`cargo run --features ssr`）
- **前端**：Next.js（应用程序路由器）在 Vercel 上，重写 `/api`、`/auth`、`/mcp` 到 Railway API
- **数据库**：Supabase Postgres 带有 RLS；公共读取门控在 SQL 策略和服务器查询中强制执行
## 自己运行
```bash
https://github.comyak/on
cd onchainai
cp .env.example .env # 填写 Supabase URL/密钥、GitHub OAuth、JWT 密钥
# API（端口 3000）
cargo run --features ssr
# 前端（端口 3001，代理到 API）
cd frontend && && API_PROXY_TARGET=http://localhost:3000 npm run dev -- --port 3001
```
> crate 的默认功能集为空，因此服务器依赖项不会泄漏到任何 WASM/中。普通的 `cargo` 命令会触及服务器代码，需要 `--features ssr`。
常见检查：
```bash
cargo test --features ssr # 测试
cargo clippy --features ssr -- -W clippy::all # 校验
cargo fmt --check # 格式化
./scripts/agent-harness-check.sh代理/开发环境自检
```
## 仓库布局
| 路径 | 内容 |
|---|---|
| `src/` | Rust API：MCP 服务器、REST `/api/v2`、身份验证、爬虫、信任/风险管道 |
| `frontend/` | Next.js 应用程序（Vercel）：公共 UI + 管理员仪表盘 |
| `plugin/onchainai/` | Claude Code 插件包（MCP 配置、`/find-tool`、技能） |
| `migrations/` | sqlx Postgres 迁移（包括 RLS 策略） |
| `docs/` | 设计文档、规范、操作员指南（[索引](docs/INDEX.md)） |
| `scripts/` | 开发/部署/验证门控（参见 `AG`） |
| `agent/`、`.agents/` | 用于在此仓库上工作的 AI代理的技能和环境配置 |
## 文档
| 文件 | 目的 |
|---|---|
| [docs/CONNECT.md](docs/CONNECT.md) | 连接任何 MCP 客户端，安装插件/技能 |
| [docs/MVP_DESIGN.md](docs/MVP_DESIGN.md) | 架构、数据库模式、爬虫、MCP 服务器 |
| [docs/X402_REFERRAL_SPEC.md](docs/X402_REFERRAL_SPEC.md) | x402 推荐/归属设计（无托管） |
| [docs/LAUNCH_READ.md](docs/LAUNCH_READINESS_SPEC.md) | 公共启动检查清单和路线图规范 |
| [docs/SECURITY.md](docs/SECURITY.md) | 安全设计：身份验证、RLS、标头、 |
| [docs/UI_UX_DESIGN.md/UI_UX_DESIGN.md) | 完整的规范 |
| [docs/OPERATOR_GUIDE.md](docs/OPERATOR_GUIDE.md) | 操作员/管理员手册（韩语） |
| [docs/BUILD_DEPLOY_RULES.md](docs/BUILD_DEPLOY_RULES.md) | 构建一致性、烟雾门控、Railway/Vercel 部署 |
| [AGENTS.md](AGENTS.md) | AI 编码代理的入口点 |
## 贡献与安全
- 欢迎贡献 — 请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。帮助最快的方式是提交 [onchain-ai.xyz/submit](https://www.onchain-ai.xyz/submit) 上缺失的工具。
- 安全报告：请参阅 [SECURITY.md](SECURITY.md)。请勿
