# @fidesbuild/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40fidesbuild/mcp-server/

版本：0\.14\.0
npm 元数据更新时间：2026-11-09T17:42:07.890Z
中文译文更新时间：2026-11-14T17:16:21.269Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fidesbuild/mcp-server
原文对照：https://npmcn.com/package/%40fidesbuild/mcp-server/?lang=original
项目主页：https://fidesbuilder.xyz/docs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：183 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.10
- 运行依赖：13 个
- 首次发布：2026-10-18T08:51:18.528Z
- 最新版本发布：2026-11-09T17:42:07.715Z
- 近 30 天下载量：2890（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

FIDES作为Claude和任何MCP客户端的工具:在已签名的FIDES内计划和执行动作,由主机中继器支付气体.

## 安装

```sh
npm install @fidesbuild/mcp-server
```

也可以使用：`pnpm add @fidesbuild/mcp-server`、`yarn add @fidesbuild/mcp-server`、`bun add @fidesbuild/mcp-server`

## README

# @ fidesbuilding/mcp-服务器

FIDES为克洛德, 和任何其他MCP应用程序。 你签过一次FIDES, 有预算, 代理商可以调用的合同和过期。 然后用简单的语言问克洛德 比如说"给一美元美金给0x..." Claude通过FIDES计划行动,向您展示FIDES内部的内容和被封锁的内容,只有在您说的时候才执行. FIDES外面的任何东西 都不会寄出去.

-   资金从你的FIDES账户转移, 从不从你的钱包.
-   服务器的代理密钥没有资金 它只能在你为它签署的FIDES内签名行动.
-   气体由主机FIDES中继器支付,因此代理密钥不需要ETH.

## 设置

1.  **加入FIDES给克洛德.**
    
    克洛德桌面: 下载 [fIDES 扩展名](https://fidesbuilder.xyz/downloads/fides.mcpb),双击并单击安装.
    
    Claude Code, 在一个终端, 在Windows上:
    
    ```bash
    claude mcp add fides -- cmd /c npx -y @fidesbuild/mcp-server@latest
    ```
    
    在 macOS 或 Linux 上:
    
    ```bash
    claude mcp add fides -- npx -y @fidesbuild/mcp-server@latest
    ```
    
2.  **在克洛德,说"设置FIDES".** Claude给了你一个FIDES应用程序的链接 上面有它的代理地址.
    
3.  **打开链接,** 确定预算、合同和到期、签署、然后创建和资助您的FIDES账户.
    
4.  **问克洛德想要什么.** 它可以自行取出签名的FIDES;没有任何下载.
    

Claude Code 和其他 MCP 应用程序需要 [节点](https://nodejs.org/) 20.10或后会. Claude桌面有它自己的.

## 工具

| 工具 | 它会做什么 |
| --- | --- |
| `fides_setup` | 与 FIDES 应用程序的链接中包含此代理 |
| `fides_status` | FIDES:在役或不在役,预算支出和剩余,FIDES账户余额,允许的合同,到期,代理地址 |
| `fides_plan` | 将转账和合同调用编成一个计划,对FIDES进行检查,分组,模拟. 无所寄出. 按功能名称和纯值调用任何经核实的合同,其编码来源为已核实的 |
| `fides_inspect_contract` | 阅读链条上的任何合同,并列出代理商可以称谓,并标出风险功能 |
| `fides_read_contract` | 从任何经核实的合同中按功能名称读取一个值,如市场或余额。 免费 |
| `fides_check_api` | 阅读一个付费的API的价格而不支付,并说一个FIDES能否支付它 |
| `fides_swap` | 在交易授权范围内进行互换 |
| `fides_execute` | 执行一个计划 由它的ID。 仅发送 FIDES 内部的动作 |
| `fides_pay_request` | 从支付价的API购买了x402:在FIDES中对照服务上限检查价格,由FIDES支付,返回回复 |
| `fides_receipts` | 在 FIDES 下执行的每笔交易, 有探索者链接 |
| `fides_help` | 你可以做什么 与FIDES, 付费API 已知工作 价格 |
| `fides_use_file` | 装入 a `fides.json` 文件,用于未在应用程序中签名的 FIDES |

使用的FIDES是该代理的最新有效签名:来自FIDES API,该应用在签名时共享FIDES,或保存在其中的复制件 `~/.fides`。每个系统在使用前都要在链上验证.

## 已支付 APIs

Claude可以从API那里 购买每个请求的收费x402, 从你的FIDES。 每项有偿服务在FIDES中以上限命名;任何未命名或超过上限的,在支付前都会被拒绝. 为了尝试,请克洛德:"将FIDES与忠诚-demo付费服务,最高可达0.1USDG相接",再签"从FIDES演示中购买链式统计"(0.01USDG用于Robinhood Chain的最新块,气价和USDG供应).

已知工作的付费API,通过FIDES通过主网实际支付购买:

| 服务编号 | 網址 | 价格 |
| --- | --- | --- |
| `fides-demo` | `https://api.fidesbuilder.xyz/v1/demo/chain-stats` | 0.01美元G(美元) |
| `spraay` | `https://gateway.spraay.app/api/v1/models` | 0.001 USDG (美元) |
| `madeonsol` | `https://madeonsol.com/api/x402/rhc/kol/feed?limit=5` | 0.04 USDG (美元) |

任何对Robinhood Chain公司收费超过x402的API(`exact`,EIP-3009同样有效. 服务代号是您在签名时选择的任何名称 。 问克洛德"你对FIDES能做什么?",在聊天中获取这份名单.

## 其他 MCP 应用程序

添加带有命令的服务器 `npx` 和论点 `-y @fidesbuild/mcp-server@latest` (关于Windows, 命令) `cmd` 和论点 `/c npx -y @fidesbuild/mcp-server@latest`) (中文(简体) ). `npx -y @fidesbuild/mcp-server setup` 制作代理键并从终端打印设置链接.

## 设置

全部可选, 设置在服务器环境中 .

| 变量 | 默认 |
| --- | --- |
| `FIDES_HOME` | `~/.fides`时 `agent.json` 并保留正在使用的FIDES |
| `FIDES_FILE` | `~/.fides/fides.json` |
| `FIDES_RPC` | `https://rpc.mainnet.chain.robinhood.com` |
| `FIDES_API` | `https://api.fidesbuilder.xyz`: 支付汽油的中继器, 并查找签名的 FIDES |
| `FIDES_APP` | `https://fidesbuilder.xyz/app`,用于设置链接 |
| `FIDES_RELAY` | 设定为 `self` 以拥有代理钥匙支付气体本身(给它一点ETH) |
| `FIDES_LOOKUP` | 设定为 `off` 只使用 FIDES 保存在 `FIDES_FILE` |
| `FIDES_AGENT_KEY` | 使用此私钥代替 `~/.fides/agent.json` |

主机中继器的日常用气预算由所有人分担. 如果它耗尽, `fides_execute` 说为; 使用 `FIDES_RELAY=self` 或试后.

文档 : [诚实建设者.xyz/docs](https://fidesbuilder.xyz/docs#/claude)

## 常见问题

### @fidesbuild/mcp-server 是什么？

FIDES作为Claude和任何MCP客户端的工具:在已签名的FIDES内计划和执行动作,由主机中继器支付气体\.

### 如何安装 @fidesbuild/mcp-server？

在项目目录运行 npm install @fidesbuild/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fides-mcp，可以用 npx fides-mcp 直接运行。

### @fidesbuild/mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fidesbuild/mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fidesbuild/mcp-server 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.10。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fidesbuild/mcp-server 可以商用吗？

@fidesbuild/mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fidesbuild/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@fidesbuild/mcp-server 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,890 次，日均约 96 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fidesbuild/mcp-server 还在维护吗？

最新版本 0\.14\.0 发布于 2026/11/10（5 天前）；至今共发布 17 个版本，其中过去 12 个月发布了 17 个；首次发布于 2026/10/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。