figuard-mcp

figuard-mcp

FiGuard MCP 服务 — 无需编写任何 SDK 代码，即可直接在 Claude Code、Cursor 或 Claude Desktop 中使用 FiGuard。

功能

为你的 AI 助手添加 14 个 FiGuard 工具。无需编写 SDK 代码，只需与 Claude 对话：

“创建一个 $500 的旅行预算，其中 $300 用于机票，$200 用于酒店” → Claude 调用 figuard_create_budget

“从此预算中授权一张 $149 的经济舱机票” → Claude 调用 figuard_authorize → 返回 AUTHORIZED 或 DENIED

“机票最终花了 $147 — 确认实际金额” → Claude 调用 figuard_confirm

要求

• Node.js 18+
• 正在运行的 FiGuard 服务（本地或沙盒）

设置

Claude Code

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

或者手动添加到 ~/.claude/claude_desktop_config.json：

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

Cursor

添加到项目中的 .cursor/mcp.json（或全局配置 ~/.cursor/mcp.json）：

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

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

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

使用沙盒（无需 Docker）

将 FIGUARD_BASE_URL 指向托管的沙盒，即可在不运行本地服务的情况下试用 FiGuard：

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

可用工具

工具	功能
figuard_create_budget	创建支出预算；返回 session_token
figuard_authorize	预先检查 — 返回 AUTHORIZED 或 DENIED 及原因
figuard_confirm	成功后，按实际金额结算预留款项
figuard_fail	操作失败时释放预留款项
figuard_void	取消未使用的预留款项
figuard_get_budget	查看预算状态、已支出、已预留和可用金额
figuard_get_ledger	列出所有支出事件，并支持筛选
figuard_resume_budget	恢复被异常检测暂停的预算
figuard_extend_budget	延长预算的到期时间
figuard_cancel_batch	一次调用取消最多 100 个预算
figuard_fund_budget	调整预算总限额（CREDIT / DEBIT / RESET / RESET_SPENT）
figuard_create_delegation_token	为各 Agent 创建针对舰队预算的限定范围令牌
figuard_revoke_delegation_token	撤销委托令牌（幂等）
figuard_get_delegation_token	查看委托令牌状态和额度使用情况

安全说明

FIGUARD_API_KEY 配置为环境变量，而不是工具参数。工具参数会出现在大模型上下文窗口中 — 绝不能将 API 密钥作为工具参数传递。

figuard_create_budget 返回的会话令牌有效期较短（会随预算到期），可在会话内安全地用作工具参数。

在本地运行 FiGuard

git clone https://github.com/figuard/figuard-core
cd figuard-core
docker compose up -d

FiGuard 将在 http://localhost:8080 上提供服务。