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 分

    請在儲存庫或註冊中心條目中宣告授權條款。