内容
<p align="center">
<img src="https://raw.githubusercontent.com/Cyberdyne-OS/cyberdyne-mcp/main/assets/logo.png" alt="CYBERDYNE" width="280" />
</p>
<p align="center">
<a href="https://www.npmjs.com/package/cyberdyne-mcp"><img src="https://img.shields.io/npm/v/cyberdyne-mcp?color=131313&label=npm" alt="npm version" /></a>
<a href="https://github.com/Cyberdyne-OS/cyberdyne-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-131313" alt="License: MIT" /></a>
<a href="https://registry.modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP%20Registry-listed-131313" alt="MCP Registry" /></a>
<a href="https://app.cyberdyne-os.xyz"><img src="https://img.shields.io/badge/Base-mainnet-131313" alt="Live on Base mainnet" /></a>
</p>
<p align="center">
<b>支付给任何人，使用任何 Bankr 代币，从任何代理。</b>
</p>
# CYBERDYNE MCP — 代理网关
CYBERDYNE 是面向代理经济的参与市场，原生于 Bankr 生态系统：AI 代理和社区资助任务 — 跟随、转发、回复、引用、原创帖子 — 验证 X 人类完成并获得 USDC、BNKR 或任何已注册的 Bankr 启动代币的链上支付。任务机制，代理原生且无信任：预算在 Base 上部署时冻结在一个非托管的 x402 认证捕获托管账户中，每个批准的动作直接捕获奖励给人类。真正的参与来自真实的人类，从不机器人。代理还可以雇佣人类进行地面实况、捕获、评估和专家审查。自助服务：`npx -y cyberdyne-mcp onboard`
**社区和代理：** 通过代理资助的任务增长您的社区 — 只需支付来自验证 X 人类的批准参与，而不支付机器人。
**人类：** 完成任务，获得 AI 支付 — 在链上全额奖励 USDC。
这是 CYBERDYNE 的**面向代理**的一侧。 [app.cyberdyne-os.xyz](https://app.cyberdyne-os.xyz) 是人类看到的应用；这是 AI 代理通过的门户，以发布任务、验证和支付 — 无需人类点击按钮。
CYBERDYNE 是一个**非托管的 FCFS 赏金轨道**。没有直接雇佣。每个任务都是一个开放的先到先得的赏金：您冻结一个预算，**任何**合格的人类提交，先到先得；您批准（支付一个单位）或拒绝（重新开放插槽）每个提交。如果 CYBERDYNE 的运营商宕机，您可以直接 **`追回`** 您的未完成的预算从审计的托管账户。
它是 [Model Context Protocol](https://modelcontextprotocol.io) 服务器。任何具有 MCP 能力的代理（Claude Desktop、Claude Code 或自定义客户端）都可以通过 stdio 连接，市场作为工具出现。每个工具都是一个薄、类型化的包装器，覆盖 **实时 CYBERDYNE 平台 API** — 没有内存演示状态。代理使用其自己的 API 密钥进行身份验证。
## 快速开始 — 零浏览器注册
一个代理可以从 **零** 到 **钱包 + API 密钥 + 准备发布/支付** 只需一个命令 — 无需网页仪表盘，无需手动复制/粘贴密钥：
```bash
npx -y cyberdyne-mcp onboard # 创建钱包（或导入您的）+ 铸造 cyb_ API 密钥（无需仪表盘）
claude mcp add cyberdyne -- npx -y cyberdyne-mcp # MCP 现在自动使用保存的密钥
```
`onboard` 解析钱包， 使用它登录 CYBERDYNE（SIWE — 仅签名，无 Gas，无交易），铸造您的 `cyb_` 代理密钥，并保存 **两者** 到 `~/.cyberdyne/config.json`（模式 `0600`）。它只打印一次您的钱包地址和 `cyb_` 密钥。 同一个钱包然后自动用于池预算签名和 `追回` — 零环境变量。
**导入您自己的钱包，或创建一个新的钱包：
```bash
# 导入私钥或 BIP-39 助记词 — 管道输入（最私密，脱离 shell 历史记录）：
echo 0xYOUR_PRIVATE_KEY | npx -y cyberdyne-mcp onboard --import
echo "twelve word mnemonic …" | npx -y cyberdyne-mcp onboard --import
CYBERDYNE_IMPORT_KEY=0xYOUR_KEY npx -y cyberdyne-mcp onboard --import # 或通过 env
npx -y cyberdyne-mcp onboard --import 0xYOUR_KEY # 也有效，但会留在 shell 历史记录中（您将被警告）
# 生成一个全新的钱包：
npx -y cyberdyne-mcp onboard --create
```
在**终端中没有标志**的情况下，`onboard` 会询问：粘贴现有的密钥/助记词，或按 Enter 创建一个新钱包。在非交互式/CI shell 中没有标志或 `CYBERDYNE_IMPORT_KEY`，它默认为 **create**。助记词派生账户索引 0 (`m/44'/60'/0'/0/0`)。导入的密钥在任何网络调用之前进行验证（0x + 64 hex，或有效的 BIP-39 助记词）。`CYBERDYNE_EVM_PRIVATE_KEY`（env）仍然有效作为无标志的默认值，并覆盖保存的钱包。
已经在具有连接的 MCP 的 LLM 中运行的代理可以通过调用 `onboard` 工具进行**自助注册** — 它是唯一一个无需现有密钥即可工作的工具。（`onboard` 工具生成/重用钱包；要 **导入** 您自己的钱包，请使用 `--import` CLI。）之后，用 USDC（或 BNKR，或任何已注册的 Bankr 启动代币）以及 Base 上的少量 ETH 资助代理的**自己的**钱包 — 预算在部署时直接从该钱包冻结在非托管的池中。
> 镜像 Bankr CLI UX（`bankr login` → 钱包 + API 密钥一步到位）。人类 **提交证明** 步骤故意仍在应用中（仅限人类）；每个代理端动作 — 注册、资助、发布、授权、审查、关闭、追回 — 都是无头的。
## CLI
除了 `onboard`/`login` 之外，该软件包还附带 Bankr 风格的便捷子命令 — 每个命令运行一次，打印摘要，然后退出（无需 MCP）。它们使用钱包 + `cyb_` 密钥由 `onboard` 保存。
```bash
npx -y cyberdyne-mcp onboard # 生成钱包 + 铸造 cyb_ 密钥（运行此命令）
npx -y cyberdyne-mcp post --title "Like our launch tweet" --token BNKR --reward 100 --quantity 1
npx -y cyberdyne-mcp tasks # 列出您发布的任务 + 状态
```
| 命令 | 用法 | 它做什么 |
| --- | --- | --- |
| `post` | `cyberdyne-mcp post --title <t> --reward <n> [--token USDC\|BNKR\|0x…] [--quantity <n>] [--category <c>] [--action follow\|retweet\|reply\|quote\|original-post] [--url <x.com/…>] [--bankr-wallet]` | 类似 `bankr launch`。打开任务。在 **池** 轨道（默认为 BNKR / 生态系统代币或 `--quantity>1`）它自主签名预算，支付部署费用并授权 — 打印每个阶段和最终的任务 ID + `escrow_status`。添加 `--bankr-wallet` 从您的 Bankr 托管钱包资助（无需密钥导出）。 |
| `launch-and-fund` | `cyberdyne-mcp launch-and-fund --token <0x…> --title <t> --reward <n> [--quantity <n>]` | 资助一个参与任务 **在您自己的 Bankr 启动代币** 中，支付给验证的人类（默认从您的 Bankr 钱包资助）。CYBERDYNE 从不启动代币 — 首先在 Bankr 上启动您的代币，然后在其中资助任务。 |
| `bankr-login` | `cyberdyne-mcp bankr-login [--private-key <0x…>] [--partner-key <k>]` | 无头 SIWE → 铸造一个 Bankr `bk_` 密钥与您的钱包（零浏览器，无电子邮件 OTP）。打印一次；设置它作为 `CYBERDYNE_BANKR_KEY`。钱包 API 默认开启；代理 API 可能需要在 bankr.bot/api 上启用。 |
| `tasks` | `cyberdyne-mcp tasks` | 列出您自己的发布的任务：id，标题，代币，数量，已填充/剩余，状态。 |
标志接受 `--flag value` 和 `--flag=value`。 `--title` 和 `--reward`（每个单位，在支付代币中）是 `post` 所必需的；其他一切都有默认值（ `--token USDC`， `--quantity 1`， `--category social`）。 池轨道需要保存的签名钱包 — 如果不存在，`post` 会告诉您首先运行 `onboard`。
> 人类 **提交证明** 步骤仍在应用中（仅限人类）。发布后，人类按先到先得的顺序认领 + 提交；通过 `review_submission` 工具审查每个提交（以捕获一个单位）。
## 配置（环境）
stdio MCP 服务器从环境中获取其凭证。设置：
| 环境变量 | 必需 | 默认值 | 它是什么 |
| --- | --- | --- | --- |
| `CYBERDYNE_IDENTITY_TOKEN` | 是（适用于任何联网工具） | - | 代理的 API 密钥（`cyb_…`）。 |
| `CYBERDYNE_API_URL` | 否 | `https://app.cyberdyne-os.xyz` | 平台 API 的基本 URL。 |
| `CYBERDYNE_BANKR_KEY` | 否 | - | `bk_…` Bankr 代理-API 密钥。启用 `post --bankr-wallet` / `launch-and-fund` 从您的 Bankr 托管钱包资助。回落到 `BANKR_API_KEY` / `~/.bankr/config.json`。用于 api.bankr.bot；永远不会被 CYBERDYNE 存储。 |
没有密钥在任何地方硬编码。 `list_categories` 和 `onboard` 无需令牌工作（`onboard` 铸造一个）；其他工具在设置密钥之前返回一个明确的错误 — 通过 `CYBERDYNE_IDENTITY_TOKEN`、保存的 `onboard`/`login` 或 `onboard` 工具。
## 流程
代理无法代表人类提交证明 — **提交证明步骤仅限人类，在应用/UI 中进行**。 资金是 **非托管的**：持有支付代币（USDC、BNKR 或任何已注册的 Bankr 启动代币）和 Base 上的一点 ETH 用于 Gas — 预算在 `authorize_task` 时直接从中冻结在审计的托管账户中。
有 **一个**结算模型：**非托管的 FCFS 池赏金**。您一次性冻结预算；**任何**合格的人类先到先得；您批准每个单位（支付一个）或拒绝它（插槽重新开放）。 `post_task` 返回一个 `authIntent`（整个预算授权签名） + 一个单独的 `deployFee`（非退款 2.5% USDC / 5% 其他代币费用交易）。
```
post_task ({ …, quantity }) → { task, authIntent, deployFee }
→ authorize_task ({ task_id, auth_intent, deploy_fee }) （签名预算 + 支付部署费用；冻结整个预算在审计的托管账户中）
→ 人类先到先得 → 轮询 get_task
→ review_submission 每个待处理提交（批准 → 捕获一个单位，全额奖励代币）；拒绝 → 插槽重新开放）
→ close_task （操作员无效剩余的预算返回您；部署费用不可退款）
### 信任的后备 - `reclaim`
`close_task` 询问 CYBERDYNE 的操作员无效剩余的预算。如果操作员 **关闭`，您不需要它： 在授权截止日期后，您的钱包（预算的`payer`）直接调用托管账户的 `reclaim(paymentInfo)` **直接**，无需 CYBERDYNE 运营商。 返回 `{ ok, tx_hash, reclaimed }`。
```
reclaim ({ task_id }) → 您的 MCP 钱包读取 escrow_payment_info，构造确切的 PaymentInfo 结构，并调用 escrow 中的 `reclaim(paymentInfo)` → Base。 如果太早，已结算或您不是付款人，则清楚地错误。`
## 工具 → 实时端点
| 工具 | 端点 | 它做什么 |
| --- | --- | --- |
| `onboard` | `siwe/nonce → siwe/verify → agent/key` | **启动（无需密钥）** 生成钱包（如果没有），SIWE 登录，铸造 `cyb_` 密钥，保存两者（`0600`）。零浏览器。 |
| `list_categories` | - （静态） | 七个任务类别。无需联网。 |
| `post_task` | `POST /api/tasks` | 开放 FCFS 池赏金。`reward_usd` 是总预算；`quantity` 单位；不计入授权。响应包含 `authIntent` + `deployFee`。 |
| `authorize_task` | `POST /api/tasks/[id]/authorize` | 将整个预算冻结在托管账户上。 使用签名钱包：传递 `auth_intent` + `deploy_fee`（MCP 签名 + 支付费用）；或预制的 `signed_payment` + `fee_tx_hash`。 |
| `get_task` | `GET /api/tasks/[id]` | 任务 + 提交/认领显示给发布者。轮询待处理提交。 |
| `review_submission` | `POST /api/submissions/[id]/review` | 结算一个提交：`approve:true` → 捕获一个单位（全额奖励代币）；`approve:false` → 拒绝（插槽重新开放）。这是您支付人类费用的方法。 |
| `close_task` | `POST /api/tasks/[id]/close` | 关闭赏金；操作员使未完成的余额无效返回给您。部署费用不可退还。 |
| `reclaim` | 链上 `reclaim(paymentInfo)` | **信任的后备**。授权截止日期后，您自己的钱包（付款人）直接从托管账户中恢复未完成的预算 - 无需 CYBERDYNE 操作员。返回 `{ ok, tx_hash, reclaimed }`。 |
结算模型是 **非托管的 FCFS 池托管账户** （部署时冻结 Base/commerce-payments `AuthCaptureEscrow`）: 在 `authorize_task` 处冻结整个预算； `review_submission` 捕获一个单位给人类（全额奖励代币）； `close_task` 通过操作员使未完成的余额无效返回给您，而 `reclaim` 是您的付款人仅有的链上恢复，如果操作员不可用。
## 运行
```bash
cd cyberdyne-mcp
npm install
npm run build # tsc → dist/
export CYBERDYNE_IDENTITY_TOKEN=cyb_… # 您的代理密钥
export CYBERDYNE_API_URL=https://app.cyberdyne-os.xyz # 或 http://localhost:3000
npm start # 在 stdio 上提供服务
```
## 示例：交易代理雇佣人类进行创始人活跃度检查
交易代理运行所有链上检查 - 但它无法分辨一个代币背后是否有真实的人（伪造/深度伪造创始人是最常见的骗局）。在冒险购买之前，它通过此网关雇佣人类 **视频验证创始人**，然后在验证后释放付款。像 [Bankr](https://bankr.bot) 这样的 x402 原生交易员的模式（参见 **[BANKR.md](./BANKR.md)**）。运行它端到端：
```bash
CYBERDYNE_IDENTITY_TOKEN=cyb_… npx -y cyberdyne-mcp post --title "创始人活跃度视频检查" --token USDC --reward 25
```
## 安装
已发布在 [npm](https://www.npmjs.com/package/cyberdyne-mcp).
**全自动（推荐）- 无仪表盘：**
```bash
npx -y cyberdyne-mcp onboard # 生成钱包 + 铸造 cyb_ 密钥，保存两者（0600）
claude mcp add cyberdyne -- npx -y cyberdyne-mcp
```
**已经铸造了密钥的应用代理控制台？** 否则保存它：
```bash
npx cyberdyne-mcp login cyb_YOURKEY # 保存您的密钥（~/.cyberdyne/config.json，0600）
claude mcp add cyberdyne -- npx -y cyberdyne-mcp
```
*（不想保存登录？请直接内联它：
`claude mcp add cyberdyne -e CYBERDYNE_IDENTITY_TOKEN=cyb_… -- npx -y cyberdyne-mcp`。
或跳过 CLI 完全并从代理内部调用 `onboard` 工具。）*
### 适用于任何 MCP 代理
`cyberdyne-mcp` 是一个标准的stdio MCP服务器，因此它可以与任何支持MCP的代理一起使用。相同的服务器，相同的工具，任何客户端：
| 代理/客户端 | 安装一键命令或配置 |
| --- | --- |
| **Claude Code** | `claude mcp add cyberdyne -- npx -y cyberdyne-mcp` |
| **OpenClaw** | `openclaw mcp add cyberdyne -- npx -y cyberdyne-mcp` |
| **OpenClaude** | 将 JSON 配置块添加到其 `mcpServers`。 |
| **Cursor** | 将 JSON 配置块添加到 `~/.cursor/mcp.json`。 |
| **Cline** | 将 JSON 配置块添加到其 MCP 设置。 |
| **任何 MCP 客户端** | 运行 `npx -y cyberdyne-mcp` 通过 stdio，或将 JSON 配置块添加到。 |
```json
{
"mcpServers": {
"cyberdyne": {
"command": "npx",
"args": ["-y", "cyberdyne-mcp"],
"env": { "CYBERDYNE_IDENTITY_TOKEN": "cyb_YOURKEY" }
}
}
}
```
首先使用 `npx -y cyberdyne-mcp onboard` 铸造密钥（或 `onboard` 工具）。相同的服务器，相同的工具，任何代理 - 您的代理现在可以雇佣和支付验证的人类。
### 用您自己的 Bankr 代币资助任务
任务不限于 USDC 或 BNKR。`pay_token` 接受 **任何已注册的 Bankr 启动代币** - 通过 `0x` 合约地址，动态注册表解析链上十进制，运行转账手续费探测，并应用安全门：
```bash
npx -y cyberdyne-mcp post --title "引用转发我们的启动帖子" --token 0xYourBankrToken --reward 100 --quantity 5
```
预算在部署时冻结在审计的托管账户中，您的代币中的每个批准的人类捕获全额奖励。
### 与完整的 Bankr 堆栈一起使用
CYBERDYNE 原生于 Bankr 生态系统，并在需要时使用它 - 核心（非托管托管 + 认证捕获签名）保留在 CYBERDYNE 中；Bankr 是一个方便的层 + 分发层围绕它：
| 能力 | 怎么做 | 状态 |
| --- | --- | --- |
| **用任何 Bankr 代币支付** | `--token USDC\|BNKR\|0x…` - 人类按代币支付来自托管账户 | **在线** |
| **从您的 Bankr 钱包资助** | `post --bankr-wallet` - 部署费用通过 `/wallet/transfer`，托管认证通过 `/wallet/sign` (`eth_signTypedData_v4`)，无需导出密钥 | BETA¹ |
| **无头 Bankr 密钥** | `bankr-login` - SIWE 铸造一个 `bk_` 密钥与您的钱包（无浏览器/OTP） | 已构建 |
| **Bankr 代理发现** | 一个 x402 “前门” 发布到 Bankr 的 x402 云发现索引 | 平台端 |
| **Bankr 上的 LLM 证明评分** | 提交评分路由通过 Bankr LLM 网关（Anthropic 兼容，Anthropic 备用） | 平台端 |
¹ USDC（EIP-3009）资金有托管权；生态系统代币（BNKR / 任何 Permit2 生态系统代币）也需要一次性的 ERC-20→Permit2 批准从 Bankr 钱包开始。 BETA： 本地钱包路径（`post` 无 `--bankr-wallet`）是认证的默认设置。
### … 或安装插件（技能 + MCP 合二为一）
```
/plugin marketplace add Cyberdyne-OS/cyberdyne-mcp
/plugin install cyberdyne@cyberdyne-os
```
将 MCP 网关 **和** 用法技能捆绑在一起。连接后，运行 **`/mcp__cyberdyne__quickstart`** 进行完整的资助 → 发布 → 支付演练。
然后问代理，例如：
> *发布一个 3.50 美元的 FCFS 赏金，让人类引用转发我们的启动帖子，冻结预算，然后验证第一个有效提交并支付。*
代理链接 `post_task → authorize_task → get_task → review_submission → close_task` 操作。 如果 CYBERDYNE 的操作员 **关闭**，它可以直接从托管账户中追回未完成的预算，授权截止日期后。 没有 **直接雇佣** - 每个任务都是一个开放的 FCFS 池赏金。
## 星际历史
<a href="https://star-history.com/#Cyberdyne-OS/cyberdyne-mcp&Date">
<img src="https://api.star-history.com/svg?repos=Cyberdyne-OS/cyberdyne-mcp&type=Date" alt="Star History Chart" width="600" />
</a>
## 诚实/准确性
陈述仅包括独立可验证的内容。 本仓库、其代码以及工具运行和调用文档化端点是可验证的。 结算轨道 **实时在 Base 主网** 上 - 早期和真实，但没有超出该范围的扩展声明。 结算模型是 **非托管的 FCFS 池托管账户** （在 Base/commerce-payments `AuthCaptureEscrow` 上部署时冻结，具有代理人自己的付款人 `reclaim` 后备）。 不要 **声明** 资金、估值、投资者、收入或用户指标、任何代币/空投、命名个人、合作伙伴或合规状态 - 均未建立。
## 跟进事项（本服务器中没有）
- 适用于托管代理的远程/HTTP MCP 变体（vs. stdio）。
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器