flario

Flar[](https://www.npmjs.com/package/flario) [](#license) [](https://nodejs.org) [](https://model.io) **Fl的 MCP 服务器。** Flario 为 AI Claude、Cursor Code 或任何 [协议](https://protocol.io) 客户端提供了一种纯语言are 的内置协议的方式：FTSO 价格馈送、FDC 跨链证明和 FAssets。它还为代理提供了一个钱包。高级工具按调用付费，[x402](https://.org/) 在 Flare 上结算，每个支付都会一个收据本身可以证明。 可以使用 `npx flario` 安装，或作为 HTTP 中心适用于公共 Flare RPC，默认情况下无需帐户或密钥即可读取，并且永远不会持有或转发资金。 Flario 涵盖了整个内置堆栈：FTSO 价格（包括带有证明的锚定馈送）、FDC 证明工作流，带有本地 Merkle 证明验证、深度 FAssets 状态（每个代理的抵押品、清算风险、系统总额、赎回队列）、Flare 投资组合读取（委托、投票权、可索赔奖励）、Songbird 和 Coston 支持，以及 Flare计算合约的监。读取是信任：FDC 和O 证明在本地链上 Relay 根，确保真实性。唯一的写入dc_request_attestation`，仅在设置 `FLARE_PRIVATE_KEY` 时才会提交交易；否则，它准备一个签名请求。 > **这与 Flare 的官方 MCP 服务器互补，而不是替代。** （`dev.flare.network/mcp`）提供，因此它为代理提供知识。Flario提供操作和钱包：它调用内置协议，并让代理为计算结果付费，带有链可以验证的。同时使用两者。 --- ## 为什么选择 Flar- **它深入协议栈，支持 Flare 内置的协议。** FTSO、FDC 和 FAssets 内置于链中，Flario 的 工具也是如此。通用多链 MCP 服务器功能，其深度到其他链。 - **答案带有证明，因此听我一面之词。** 价格和跨链事实带有 Merkle 证明，Flario 在本地检查与链上根，确保真实性。代理或智能合约可以依赖答案，无需信任。 - **代理，并且会收到收据。** 高级工具x402](https://www.x402.org/) 在 Flare 上结算每个调用，并且每个支付都会返回一个可移植的收据，Flare 自己的 FDC 可以证明，而不仅仅是促进者的说法。目前，x402 生态系统中没有其他链可以做到这一点。 - **自托管，无托管。** 它在公共 RPC 上运行，不需要帐户或密钥来读取数据，并且永远不会触及您的资金。 --- ## 示例 一旦 Flario 在您的 MCP 客户端中参阅[安装](#安装)），您只需用纯语言询问： | 向代理提问 |io 运行 | | --- | --- | | “Flare 上的 FLR/USD 价格是多少，带有我可以检查的证明？” | `get_ftso_anchor_feed` | | “目前哪些 FXRP 代理最接近清算？” | `fassets_liquidation_scanner` | | “显示 `0x...` 的 FLR 投资组合：余额、委托、可索赔奖励。” | `get_flr_stake_info` | | “谁在运行 FXRP 代理x...`？” | `fassets_agent_details` | | “使用 Flare 的 FDC 证明此结算确实发生。” | `fdc_verify_settlement` | 的价格会带着值和证明返回，代理可以自行验证（修剪）： ```json { "verified": true, "verification": "本地：keccakabi.encode(feed body)) 折叠通过 Merkle 证明等于链上读取的 Relay.merkleRoots( round)", "name": "FLR/USD", "price": 0.006786, "voting_round_id": 1402671, "merkle_root": "0x...", "proof": ["0x...", "0x..."] } ``` --- ## 安装 ### 克劳德桌面 编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config（Windows）并添加： ```json { "mcpServers": { "flario": { ": "npx "args": ["-y", "flario"], "env": { "FLARE_RPC": "https://flare-api.flare.network/ext/C/rpc", "FLPC_TESTNEThttps://coston2-api.flare.network/ext/C/rpc" } } } } ``` 重启克劳德桌面，然后询问类似“Flare 上的 FLR/USD 价格是多少？”或“现在 FXRP 铸造了多少？”。 ### 光标 编辑 `~/.cursor/mcp.json`（全局）或 `.cursor/mcp.json`（每个项目）并添加： ```json { "mcpServers": { "flario": { "command": "npx", "args": ["-y", "flario"] } } } ``` 相同的块适用于任何支持 stdio 客户端（VS Code、Windsurf、Zed 等）。`env` 块是可选的，因为默认情况下使用公共 Flare RPC。 ### 检查它是否有效（无客户端，~10 秒） ```bash # 直接从已发布的包中列出所有 19 种工具： npx -y @modelcontextprotocol/inspector --cli npx -y flmethod tools/list # 或调用一个，带有 FLR/USD 价格在主网上： npx -y @modelcontextprotocol/inspector --cli npx -y flario \ tools/call --tool-name get_ftso_anchor_feed \ -arg feed_id=FLR/USD --tool-arg network=mainnet ``` --- ## 工具 每个工具都使用 [zod](zod.dev其输入，并在 RPC 调用宕机时返回清晰信息，而不是崩溃。十七种工具免费。两种高级工具在操作时通过 [x402 在 Flare](#如何支付-x402) 结算，否则免费。 | 工具 | 网络 | 层级 | 功能 | | --- | --- | --- | --- | | `get_flr_balance` | mainneton2, songbird, coston | 免费 | 地址的原生 FLR 加上包装 WFLR（WNat）余额 | | `get_flr_stake_info` | mainneton2, songbird, coston | 免费 | 投资组合：FLR 和 WFLR，投票权，委托，可索赔奖励，按来源划分，FlareDrops | | `get_ftso_feed` | mainnet, coston2, songbird, coston | 免费 | 单个 FTSO 馈送的最新价格（`"FLR/USD"` 或 `` id） | | `get_ftso_feeds_all` | mainnet, coston2, songbird, coston | 免费 | 每个捆绑馈送的最新价格 | | `get_ftso_providers` | mainnet, coston2（参见备注） | 免费 | 活跃的 FTSO 数据提供者 | | `get_ftso_anchor_feed` | mainnet, coston2, songbird, coston | 免费 | 带有 Merkle 证明的 FTSO 缩放价格，本地检查与链上 Relay 根 | | `get_ftso_history` | mainnet, coston2, songbird, coston | 免费 | 来自公共 DA 层的最近 FTSO 缩放锚定馈送历史，每个点 Merkle 验证 | | `get_fassets_status` | mainnet, coston2 | 免费 | FAssets 铸造总金额和代理数量（简要摘要；参见 `fassets_system_state`） | | `get_fdc_proof_status` | mainnet, coston2, songbird, coston | 免费 | FDC Merkle 根和某一轮的最终确定 | | `get_smart_account_info` | mainnet, coston2（参见备注） | 免费 | 解析 XRPL 帐户的 Flare 地址 | | `fdc_request_attestation` | mainnet, coston2, songbird, coston | 免费 | 准备并可选地提交 FDC 证明请求。返回交易哈希和投票轮 ID | | `fdc_get_attestation_proof` | mainnet, coston2, songbird, coston | 免费 | 从 DA 层获取证明并在本地验证与链上 Relay 根 | | `fassets_agent_status` | mainnet, coston2, songbird | 免费 | 每个代理的抵押比率，铸造能力，清算状态（风险最高优先） | | `fassets_system_state` | mainnet, coston2, songbird | 免费 | 总铸造，批量大小，铸造上限和暂停，聚合抵押品，赎回队列 | | `fassets_agent_details` | mainnet, coston2, songbird | 免费 | 代理名称，描述，徽标，使用条款，许可状态（AgentOwnerRegistry） | | `songcc_registry` | songbird（默认），所有 | 免费 | 扫描 Flare 机密PMW，TEE）部署的实时合约注册表 | | `fdc_verify_settlement` | mainnet, coston2, songbird, coston | 免费 | 通过内置 FDC（EVMTransaction 证明）证明 x402 结算并将其绑定到支付 | | `fassets_liquidation_scanner` | mainnet, coston2, songbird | 高级（x402） | FAssets 代理加入实时 FTSO 价格：每个代理的清算价格及其距离 | | `fdc_bulk_proof_bundle` | mainnet, coston2, songbird, coston | 高级（x402） | 批量获取和本地验证最多 20 个 FDC 证明 | 备注： 级工具在操作员设置 `X402_ENABLED=true` 时免费运行。参见 [支付方式](#如何支付-x402)。 - `get_ftso_providers` 需要一个外部索引器端点（使用下面的 env 变量设置）。在链上聚合提供者对于只读 stdio 服务器来说不实用。 - `get_smart_account_info` 是尽力而为的。MasterAccountController ABI 尚未在外围文物中发布，因此当无法解析时，它会返回一个 `has_account: false` 通知。 ### FDC 证明流程 ```text 1. fdc_request_attestation （类型：Payment | AddressValidity | EVMTransaction， 源链： | btc | doge | eth | flr | sgb） -> 验证者 prepareRequest -> 费用报价 -> FdcHub.requestAttestation -> { tx_hash, voting_round_id, abi_encoded_request } 2. 等待 ~90 到 180 秒，直到投票轮最终确定 3. fdc_get_attestation_proof（voting_round_id, abi_encoded_request） -> DA 层证明 -> 本地 keccak256 Merkle 折叠 -> 必须等于 Relay.merk(200, round)上读取 -> 验证响应 ``` 在没有 `FLARE_PRIVATE_KEY` 的情况下，步骤 1 返回 `mode: "prepared_only"`，带有编码请求、费用和 FdcHub 地址，以便您可以使用自己的签名者提交它。当设置密钥时，它只会在本地签名。 --- ## 支付方式（x402） Flario 在 MCP 上实现了 [x402 支付协议](https://www.x402。据我所知，它是第一个付费工具在提供服务的同一链上结算的 MCP 服务器。HTTP 的 402 状态和 `X-Payment` 头映射到工具结果和工具参数： ```text 1.费工具 -> 结果：{ x402_payment_required: true, 接受：[要求] } 2. 在链下签名 EIP-3009 TransferWithAuthorization（对支付者来说无需 gas） 3. 重试相同的调用，带有 -> x402_payment: base64(JSON 载荷. 服务器在本地检查 EIP-712 签名，检查链上的随机数， 在 Flare 上结算 transferWithAuthorization，运行工具 -> 结果包括 x402_payment_rece结算摘要 x402_receipt可移植的、ZK-ready；IPT_SPEC``` 内置促进者永远不会持有资金。`transferWithAuthorization将代币者转移到收款人，操作员密钥仅 以广播客户端已经签名的授权。重放被阻止两次：EIP-3009 随机数在链上被消耗，结算随机数也在进程中被缓存。 每次付费调用都会返回一个可移植的 `x402_receipt`。这模式的自描述记录，支付者仅作为 Pose承诺出现以明文显示，并带有 keccak256 `receipt_hash`，任何都可以重新检查。支付者可以使用支付载可选 `commitment_salt`承诺。完整规范：[`RECEIPT_SPEC.md`](RECEIPT_SPEC.md)。 ### FDC 验证结算（我最自豪收据声已结算。Flare 可以使用其自己的内置数据连接器证明这一点。`_verify_settlement`交易，获取 FDCTransaction 证明，本地验证 Merkle 证明上 Relay 根，并将证明绑定到支付：它确认证明的交易确实包含一个 ERC-20 `Transfer` 到收款人，至少包含该结果是一个收据，其 `fdc_attestation_ref使得结算在不信任可证明。目前，x402 生态系统中链可以生成此类协议级收据。该工具永远不会提交交易（证明请求是无许可的，因此持有者提交它），这意味着托管中心无法被诱骗烧 Gas。 操作员设置： ```bash X402_ENABLED=true X402_NETWORK=coston2 net 还需要 X402NET=true X402_PAY0xYourPayeeAddressARE_PRIVATE_KEY=0x... # 操作员的 gas 密钥用于结算 # 可选：X_ADDRESS，X402_PRICE_DEFAULT=0.001， # X402_PRICESETS_LIQUIDATION_SCANNER=0.005 （整代币单位支付代币（EIP-3009，在 2026 年 7 月在链上检查）：Coston2 默认使用 `0xce1394896200b543a61E4ae8E829E8EB` （一个测试 USDT0），主网默认 [USD₮0](https://docs.usdt/technical-documentation/developer#flare) 在 `0xe7cd86e13AC4309349F30B3435a9d337750fC82D`。您可以使用 `npx tsx scripts/x402-demo-client.ts` 运行整个代理流程。 --- ## 作为中心运行 您可以将 Flario 作为网络服务运行，而不是作为本地 stdio 进程： ```bash npx flario --8402 # 或 FLARIO_HTTP8402 # 暴露给 localhost 以外的FLARIO_HTTP_HOST=0.0.px flario --http 8402 ``` | 提供服务 | | --- | | `POST /mcp` | 完整的 MCP 服务器通过 Streamable HTTP），所有 19，x402 带内 `GET /api/preliquidation-scanner?FXRP&network=` | HTTP x402：` 加 `accepts，重试并带有 `X-Payment` 头，获取 `X-Payment- `POST /mium/proof-bundle` | x402 流程。主体：requests":[{"voting":N,"abi_encoded_request":"..."}],"network":"..."}` | GET /` | 发现点402 配置，定| `GET /healthz` | 存活 | REST 端点使用402 线格式（`X-Payment` 中的 base64 JSON），因此 代理和现有的 x402 客户端也可以支付。存储库中Dockerfile`： ```bash docker build -t flario-h && docker run -p 8402:8402 \ -e X=true -e X402_PAY_TO=0xYou -e FLARE=0x... flario-hub ``` --- ## 网络 | 链 ID | 默认 RPC | 覆盖 env 变量 | | --- | --- | --- | --- | | 主网 | `14` |flare-api.flare.networkpc` | `FLARE` | | Coston2 测试网 | `114` | `httpsoston2-api.flare.network/ext/C/rpc` | `FLARE_TESTNET` | | Songbird 测试网 | `19` | `bird-api.flare.network/ext/C/rpc` | `FLARE_SONGBIRD` | | Coston 测试网 | `16` | `https://coston-api.flare.network/ext/C/rpc `FLARE_RPC_COST | 合约地址从不硬编码。在运行时，它们通过 Flare 的 `ContractRegistry` 解析，该注册表位于 `0xaD67FEFb8dFE9d6b1b4240d8650e30F6019`（所有四个网络都是相同的地址）。FDC 验证器和数据可用性端点默认为 Flare 托管的公共服务，列在 [dev.flare.network/network/overview](https://dev.flare.network/network/overview)。 ### 配置 以下所有内容均为可选。服务器在没有任何配置的情况下，可以与公共 RPC 和 Flare 托管的 FDC 服务一起运行。 | 变量 | 使用者 | 目的 | | --- | --- | | `FLARE_RPC` | 所有主网调用 | 覆盖主网 RPC 端点。 | | `FLARE_RPC_TESTNET` |on2 调用 | 覆盖 Coston2 RPC 端点。 | FLARE_RPC_SONGBIRD` | 所有 Songbird 调用 | 覆盖 Songbird RPC 端点。 | | `FLARE_RPC_COSTON` | 所有 Coston 调用 | 覆盖 Coston RPC 端点。 | FLARE_PRIVATE_KEY` | `fdc_request_attestation` |证明请求的本地签名密钥。永不记录，永不离开进程，除非作为签名交易。将其留进入准备模式。 | |DC_VERIFIER_API_KEY` | `fdc_request_attestation` | 验证器 API 密钥。默认为公共密钥 `00000000-0000-0000-0000-000000000000`。 | | `FLARE_DA_API_KEY` | `fdc_get_attestation_proof` | DA 密钥。默认为公共密钥。 | | `FLARE_DA_URL` | `fdc_get_attestation_proof` | 覆盖 DA 层基本 URL（例如，自托管实例）。 | | `X402_ENABLED` | 高级工具 | `true` 打开 x402 付费墙，适用于高级工具。默认关闭，因此高级工具免费。 | |402_NETWORK` | x402 | 结算网络（默认为 `coston2`；`mainnet` 还X402_ALLOW_MAINNET=true`）。 | | `X402_PAY | x402 | 接收启用时必填| `X402_TOKEN_ADDRESS x402 | EIP-3009 支付代币覆盖（Coston2 测试 USDT0，主网 USD₮0）。 | | `X402_PRICE_DEFAULT` / `X402_PRICE_<TOOL>` | x402 | 整代币单位的价格（默认为 `0.001 | | `FLARE_PROVIDERS_API` | `get_ftso_providers` | 返回提供者 JSON 数组的索引器端点（或 `{ "providers": [...] } | | `FLARE_MET`get_fassets_status 可选的备用指标 API上读取失败时使用参见 [.env.example](.example) 获取复制粘贴模板。 --- ## 开发 ```bash git clone https://github.com/dziuba0x/flario.git cd flario npm install npm run dev # 监视模式，通过 tsx，无需构建步骤 npm run build # 类型检查并编译到 dist/ npm test # 离线测试套件，录制的固定装置，无网络 npm start # 运行编译后的服务器 npm run inspect # 在构建的服务器上打开 MCP 检查器 npx ts/live-check.ts # 对公共 RPC 进行实时检查（主网，Coston2，Songbird技术栈：TypeScript（ESM，Node 18+），[`@modelcontext`](https://github.com/modelcontextprotocol/typescript-sdk)，[`viem`](https://viem.sh)，[`zod`](https://zod.dev)，和 [`@flarenetwork-periphery-contract-artifacts`](https://github.com/flare-foundation/flare-npm-periphery-package)。 您可以使用检查器 CLI 在不使用客户端的情况下测试单个工具： ```bash npx @modelcontextprotocol/inspector --cli node dist/index.js \ --method tools/call --tool-name get_ftso_feed \ --tool-arg feed_id=FLR/USD --tool-arg network=mainnet ``` --- ## 许可证 [MIT](#license)， Dziuba Technology / Alan。 在 [Flare Network](https://dev.network) 上构建。欢迎提出问题和贡献。