Figuard Mcp

io.github.figuard由 GitHub 账号 figuard 发布v1.2.0更新于 Oct 24, 2026

Pre-flight spend authorization for AI agents. Set a budget, enforce limits, audit every decision.

已验证STDIO仅桌面金融安全与监控

概览

AI 生成的概览

本地 MCP 服务器，为 AI 助手提供 FiGuard 支出管控：创建预算、支出前授权，并审计每一次决策。

可以做什么
创建和管理支出预算，包括调整额度、延长有效期、恢复被冻结的预算以及批量取消预算，并查看预算状态、已花、预留和可用金额以及可筛选的支出流水。执行支出前授权检查，返回 AUTHORIZED 或 DENIED 及原因，随后确认实际金额、释放失败的预留或作废未使用的预留。针对团队预算创建、查看和撤销按代理限定的委托令牌。可嵌入运行于本地 SQLite 文件，也可连接自建或托管的沙箱 FiGuard 服务器。
适用场景
当助手需要代你花钱或占用资源，而你希望在付款前设有预算上限、预检审批步骤，并保留每次决策的可审计记录时适用。
运行要求
需要 Node.js 18+。通过 npx 作为本地 stdio 进程运行。嵌入模式只需本地 SQLite 文件（默认位于用户主目录下）。服务器模式需要在 FIGUARD_BASE_URL 中提供运行中的 FiGuard 服务器地址，并在 FIGUARD_API_KEY 中提供 API 密钥；也提供托管沙箱。后端模式由 FIGUARD_MODE 选择。
安装前请注意
FIGUARD_API_KEY 中的 API 密钥属于凭据，应保留在环境变量中，不要放进工具参数。相关工具会创建、充值、延长、取消和作废预算并调整额度，会改变真实支出状态；授权决策直接关系到资金。创建预算返回的会话令牌有效期短，但可作为工具参数使用。在服务器或沙箱模式下，预算和流水数据会发送到该远程 FiGuard 服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Figuard Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

figuard-mcp

FiGuard MCP server — use FiGuard directly from Claude Code, Cursor, or Claude Desktop without writing any SDK code.

What this does

Adds 14 FiGuard tools to your AI assistant. Instead of writing SDK code, you just talk to Claude:

"Create a $500 travel budget with $300 for flights and $200 for hotels" → Claude calls figuard_create_budget

"Authorize a $149 economy flight from this budget" → Claude calls figuard_authorize → returns AUTHORIZED or DENIED

"The flight ended up costing $147 — confirm the actual amount" → Claude calls figuard_confirm

Requirements

  • Node.js 18+
  • A running FiGuard server (local or sandbox)

Setup

Claude Code

bash
claude mcp add figuard-mcp \  --env FIGUARD_API_KEY=fg_live_... \  --env FIGUARD_BASE_URL=http://localhost:8080

Or add to ~/.claude/claude_desktop_config.json manually:

json
{  "mcpServers": {    "figuard": {      "command": "npx",      "args": ["figuard-mcp"],      "env": {        "FIGUARD_API_KEY": "fg_live_...",        "FIGUARD_BASE_URL": "http://localhost:8080"      }    }  }}

Cursor

Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):

json
{  "mcpServers": {    "figuard": {      "command": "npx",      "args": ["figuard-mcp"],      "env": {        "FIGUARD_API_KEY": "fg_live_...",        "FIGUARD_BASE_URL": "http://localhost:8080"      }    }  }}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

json
{  "mcpServers": {    "figuard": {      "command": "npx",      "args": ["figuard-mcp"],      "env": {        "FIGUARD_API_KEY": "fg_live_...",        "FIGUARD_BASE_URL": "http://localhost:8080"      }    }  }}

Using the sandbox (no Docker required)

Point FIGUARD_BASE_URL at the hosted sandbox to try FiGuard without running a local server:

json
{  "FIGUARD_API_KEY": "sb_live_demo",  "FIGUARD_BASE_URL": "https://figuard-sandbox-g1ha.onrender.com"}

Available tools

ToolWhat it does
figuard_create_budgetCreate a spending envelope; returns session_token
figuard_authorizePre-flight check — AUTHORIZED or DENIED with reason
figuard_confirmClose a reservation with the actual amount after success
figuard_failRelease a reservation when the action fails
figuard_voidCancel an unused reservation
figuard_get_budgetCheck budget status, spent, reserved, available
figuard_get_ledgerList all spend events with filtering
figuard_resume_budgetUnfreeze a budget paused by anomaly detection
figuard_extend_budgetExtend a budget's expiry time
figuard_cancel_batchCancel up to 100 budgets in one call
figuard_fund_budgetAdjust a budget's total limit (CREDIT / DEBIT / RESET / RESET_SPENT)
figuard_create_delegation_tokenCreate a scoped per-agent token against a fleet budget
figuard_revoke_delegation_tokenRevoke a delegation token (idempotent)
figuard_get_delegation_tokenCheck delegation token state and cap usage

Security note

FIGUARD_API_KEY is configured as an environment variable, not a tool argument. Tool arguments appear in LLM context windows — API keys must never be passed as tool parameters.

Session tokens returned by figuard_create_budget are short-lived (they expire with the budget) and are safe to use as tool arguments within a session.

Running FiGuard locally

bash
git clone https://github.com/figuard/figuard-corecd figuard-coredocker compose up -d

FiGuard will be available at http://localhost:8080.

来源：packages/mcp/README.md，提交 9bc8430

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.2.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。