InFlow — agentic MPP (Machine Payments Protocol) / x402 payments from your machine.

Name: InFlow — agentic MPP (Machine Payments Protocol) / x402 payments from your machine.
Author: inflowpayai

本地服务

github.com/inflowpayai开发工具10今天更新

代码仓库

关于 InFlow — agentic MPP (Machine Payments Protocol) / x402 payments from your machine.

InFlow 是用于 Agent 服务发现、接入和支付的命令行客户端与 MCP 服务。它支持通过 ODP 发现服务、通过 AEP 建立访问权限，并使用 MPP 或 x402 支付受保护端点；凭据保存在加密的本地保险库中。

主要功能

01通过 ODP 发现服务与产品
02通过 AEP 建立服务访问权限
03使用 MPP 或 x402 支付受保护端点
04在加密本地保险库中管理凭据
05提供 Agent 技能与 MCP 服务

适用场景

01查找服务和可执行操作
02接入服务并管理凭据
03检查并支付 MPP 或 x402 保护的端点
04向集成 MCP 的助手提供商业工作流

MCP 相关

InFlow 二进制文件内置 MCP 服务，可通过 `inflow --mcp` 启动；插件将其与 Agent 技能打包。MCP 客户端可使用其发现、接入和支付工作流。

#cli #mcp #payments #onboarding #wallet #mpp #ai-agents #stablecoins #http-402 #mcp-server #agent-skills #x402 #agentic-commerce #agentic-payments

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "inflow-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@inflowpayai/inflow"
      ]
    }
  }
}

启动命令npx -y @inflowpayai/inflow

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@inflowpayai/inflowstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
clientName	string	否	设备授权期间向用户显示的 Agent 或应用名称。
interval	number	否	内联轮询间隔（秒）。0 表示立即返回验证 URL 和后续命令提示；正值表示持续轮询，直到设备流程结束。
maxAttempts	number	否	轮询次数上限。0 表示不限制（仅受 --timeout 限制）。
timeout	number	否	轮询截止时间（秒）。

详细介绍

inflow

InFlow 是面向智能 Agent 发现、入驻和支付的命令行客户端。

Agent 通过 ODP 发现服务和产品，通过 AEP 建立服务访问权限，并通过 MPP 或 x402 支付受保护的端点。用户也可以通过集成 MCP 的助手或 InFlow CLI 使用相同的工作流。

初次使用？请从 packages/cli/README.md 中的命令参考开始，其中介绍了 auth、ODP 发现、x402 和 mpp 命令组、全局标志，以及面向 Agent 的（--format）输出格式。

要安装到 Agent 宿主中？请参阅对应界面的指南： docs/development/surfaces-and-testing.md。

安装

InFlow 以签名原生应用的形式分发。npm 包仅提供兼容性说明，不会运行命令、启动 MCP 或管理凭据。

公开安装支持 Apple Silicon 和 Intel Mac、Windows x64 和 ARM64，以及 Linux ARM64 和 AMD64。Homebrew、托管安装程序、WinGet 和 GitHub Release 直接下载均会为各平台安装签名原生应用。

Homebrew Cask

brew tap inflowpayai/tap
brew install --cask inflow
inflow --version

通过 Homebrew 升级或卸载：

brew upgrade --cask inflow
brew uninstall --cask inflow

托管安装程序

适用于 macOS、Debian/Ubuntu 和 Fedora/RHEL：

curl -fsSL https://inflowcli.ai/install.sh | bash

在 macOS 上，安装程序会选择当前架构，验证校验和、代码签名及 Gatekeeper 检查，将 InFlow.app 安装到 ~/.local/share/inflow，并将 inflow 链接到 ~/.local/bin。在 Linux 上，安装程序会验证 OpenPGP 签名的发布清单和软件包校验和，然后安装匹配的 Debian 或 RPM 系统软件包。

再次运行安装程序即可升级到最新的 GitHub Release。使用以下命令卸载：

curl -fsSL https://inflowcli.ai/install.sh | bash -s -- --uninstall

在 Windows 上，以能够批准 Windows Installer 提权提示的用户身份运行 PowerShell：

irm https://inflowcli.ai/install.ps1 | iex

PowerShell 安装程序会选择 x64 或 ARM64，验证 MSI 校验和、Authenticode 状态和发布者，然后通过 Windows Installer 安装软件包。再次运行即可升级。如需卸载并保留加密保管库数据：

$env:INFLOW_UNINSTALL = '1'
try { irm https://inflowcli.ai/install.ps1 | iex } finally { Remove-Item Env:INFLOW_UNINSTALL }

兼容性 shell 端点会在 macOS、Linux 和类似 Git Bash 的 Windows 环境中调用平台安装程序：

curl -fsSL https://inflowcli.ai/cli | bash

WinGet

winget install --id InFlowPayAI.InFlow --exact

通过 WinGet 升级或卸载：

winget upgrade --id InFlowPayAI.InFlow --exact
winget uninstall --id InFlowPayAI.InFlow --exact

直接下载

从 inflowpayai/inflow-cli GitHub Release 下载与软件包版本对应的制品：

Apple Silicon Mac：inflow-<version>-darwin-arm64.zip
Intel Mac：inflow-<version>-darwin-x64.zip
Windows ARM64：inflow-<version>-windows-arm64.msi
Windows x64：inflow-<version>-windows-x64.msi

zip 包含 InFlow.app；可执行文件位于应用包内的 InFlow.app/Contents/MacOS/inflow。

Linux 版本包含 ARM64 和 AMD64 Debian 软件包、RPM 软件包以及独立归档文件。Debian 和 RPM 软件包会安装 Linux 安全模型所需的系统保险库服务。

Windows MSI 软件包会安装命令行应用及其按需启动的保险库服务。Windows 会在安装前验证 Authenticode 签名和发布者。

初始化凭证保险库

涉及凭证的命令使用加密的本地 InFlow 保险库。请在由人控制的终端中初始化或解锁：

inflow vault unlock

PIN 或密码短语仅从终端读取。它不是 MCP 参数、命令行标志、环境变量或结构化 Agent 输入。inflow vault status、inflow vault lock 和 inflow vault policy 无需解锁因子。

Agent 技能

该仓库发布了三个可安装的 Agent 技能：

技能	用途
`agentic-discovery`	查找服务和产品、浏览集合，并通过 ODP 解析操作。
`agentic-enrollment`	注册 AEP 服务并管理服务凭证。
`agentic-payments`	检查并支付受 MPP 或 x402 保护的端点。

通过 Skills CLI 安装全部三项技能：

npx skills add inflowpayai/inflow-cli

InFlow 二进制文件内嵌了相同的操作指南。对于无法直接安装技能的 Agent 宿主，--skill 会输出操作指南；它不会安装技能：

inflow --skill agentic-discovery
inflow --skill agentic-enrollment
inflow --skill agentic-payments

该仓库还提供可安装的插件（捆绑技能和 MCP 服务），适用于支持插件的宿主：

Claude Code — 添加市场，然后安装插件：
```
/plugin marketplace add inflowpayai/inflow-cli
/plugin install inflow@inflow
```
这里的 inflowpayai/inflow-cli 是 GitHub 仓库标识；市场、插件和二进制文件均命名为 inflow，因此安装目标是 inflow@inflow。
Cursor / Codex — 将宿主指向此仓库；它会分别发现 .cursor-plugin/marketplace.json、.agents/plugins/marketplace.json 和 .codex-plugin/plugin.json。

无论哪种情况，插件都会捆绑技能和 inflow MCP 服务（.mcp.json）。默认 MCP 条目会运行 inflow --mcp；使用 MCP 服务前，请先安装经过签名的原生二进制文件。

首个 Agentic Commerce 流程

买家侧命令行工作流使用标准 InFlow 账户。接受付款的服务运营方需要单独的卖家账户，以及相应的 Node.js 卖家 SDK。

# Human-controlled setup
inflow vault unlock
inflow auth login

# Discover Services and Collections, then inspect a Service
inflow directory search plants --source odp
inflow inspect https://service.example

# Establish access when the Service requires enrollment
inflow aep enroll https://service.example

# Inspect and pay the protected endpoint selected from an ODP Action
inflow mpp inspect https://service.example/actions/purchase
inflow mpp pay https://service.example/actions/purchase

这三层协议可以组合使用，并非每个请求都必须使用。ODP 用于标识服务、产品和可执行操作。需要时，AEP 用于建立服务访问权限。当所选端点返回付款质询时，MPP 或 x402 用于完成付款。如果尚不清楚需要哪些层，请从 inflow inspect 开始。

如需使用已关联的卡付款，请根据卖家的报价选择普通 Instrument 付款或带 VIC 额度的 MPP CARD。卡和额度在你的 InFlow 控制面板中管理。这两种方式都使用你选择的卡或主卡，而非 InFlow USD 钱包余额。

发现公开的 OpenAPI 无需登录：

inflow directory search --source openapi
inflow openapi operations list https://parallelmpp.dev/openapi.json
inflow openapi operations get https://parallelmpp.dev/openapi.json --method POST --path /api/search

将 Directory 结果中的 service.source.url 传递给 OpenAPI 命令。读取操作详情不会调用该操作，也不会付款。对于 Collection 结果，添加 --collection-id <collection.id> 以列出其选定的操作。使用 --tag <tag> 按提供方的精确操作标签筛选。不使用这两个筛选条件时，会列出完整文档。

使用 inflow openapi operations prepare，并搭配相同的操作选择器以及 --data 或 --parameters，即可预览请求而不发送请求。若公布了多个服务器，则必须明确选择。可识别的凭据会被脱敏，但普通请求数据仍会显示；请参阅准备请求而不发送的参考文档。

使用 inflow openapi operations call，并搭配相同的输入，即可发送操作。公布的付费操作会返回 MPP/x402 命令指引，但不会发送请求；意外收到的 402 响应也会导致流程停止，不会付款。有关响应输出以及明确的身份验证／付款交接，请参阅调用 OpenAPI 操作的参考文档。

安全性和本地数据

OAuth 令牌、API 密钥和 Agent Enrollment Protocol 凭据会加密后存储在本地 SQLite 保管库中。
保管库守护进程只接受经过身份验证的本地 InFlow 客户端，并且仅提供针对精确引用的机密信息操作，不提供付款、网络、签名或命令执行操作。
守护进程会对客户端进行身份验证，客户端也会在传输请求前对守护进程进行身份验证。
保管库解锁因素只能在人工操作的终端中输入。保管库锁定时，Agent 和 MCP 执行会以安全失败方式停止。
macOS 使用经过签名的应用身份。Windows 使用经 Authenticode 签名的应用和 Windows 服务身份。Linux 软件包会安装系统服务，并强制执行可执行文件、套接字、对端、租户和软件包身份检查。
inflow auth logout 和 inflow vault reset 会移除本地凭据和保管库状态。卸载软件包会保留加密的保管库数据，除非请求执行特定平台的清除操作。

InFlow 会发送经过身份验证的 API 请求、用户请求的卖家资源请求，以及 GitHub Release 版本检查提示。设置 NO_UPDATE_NOTIFIER=1 可禁用版本检查。该检查的截止时间为两秒，且不会发送凭据。

升级与故障排查

使用 brew upgrade --cask inflow 升级 Homebrew 安装，使用 winget upgrade --id InFlowPayAI.InFlow --exact 升级 WinGet 安装，或重新运行对应平台的安装程序以升级托管安装。CLI 可能会提示有更新的已签名版本，但只要 API 未返回 VERSION_UNSUPPORTED，就会继续运行。

如果 Agent 或 MCP 工具报告保险库已锁定，请在终端中自行运行 inflow vault unlock，然后重试操作。切勿将 PIN 或口令粘贴到提示词或 MCP 工具输入中。

使用 inflow auth status --format json 检查身份验证和环境状态，并使用 inflow vault status 检查本地保险库和守护进程。有关特定主机的 MCP 故障排查，请参阅界面安装与测试指南。

开发

这是一个 pnpm + Turborepo 单体仓库。需要 Node >= 24.15.0。

pnpm install
pnpm build
pnpm test

其他实用任务：

pnpm typecheck
pnpm lint
pnpm typedoc
pnpm changeset

发布自动化

生产版本发布使用单一的原生工作流，在发布不可变的 GitHub Release、更新 Homebrew 并生成 WinGet 提交清单之前，对 macOS、Windows 和 Linux 构建产物进行签名和验证。有关工作流模式、平台凭据、签名顺序和恢复流程，请参阅原生发布指南。

软件包

@inflowpayai/inflow（packages/cli）——已发布的二进制文件，也是任何集成 InFlow 的入口。它是基于 inflow-core 的轻量渲染外壳。完整命令参考请参阅 packages/cli/README.md。
@inflowpayai/inflow-core（packages/core）——二进制文件背后的无头 InFlow 客户端。每个命令组都有一个增强句柄（inflow.auth、inflow.user、inflow.balances、inflow.depositAddresses、inflow.subscriptions、inflow.x402、inflow.mpp），同时包含协议原语和与命令对应的操作，以及使二者得以运行的辅助工具（清理、轮询、卖方探测）。目前仅供工作区内部使用；可参阅 packages/core/examples/ 中可运行的脚本。

文档导航

CLI 命令参考 - 命令、标志、输出约定和错误。
无头客户端 - CLI 使用的程序化接口。
Agent 接入方式 - 技能、插件和 MCP 设置。
原生发布指南 - 平台安装程序、签名和发布恢复。

仓库

https://github.com/inflowpayai/inflow-cli

许可证

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。