Figranium MCP

使用 MCP 搭配 Figranium

Figranium 可将网站工作流转化为可复用的任务，AI Agent 可以通过 MCP 发现、创建和运行这些任务。此服务是本地 STDIO 客户端，用于将兼容 MCP 的应用连接到你的 Figranium 实例。

想使用托管式 OAuth MCP？请将兼容的远程 MCP 客户端连接到 https://mcp.figranium.dev/mcp。

快速开始

你需要一个正在运行的 Figranium 实例，以及从 Figranium 设置中获取的 API 密钥。

直接从 npm 运行 MCP 服务：

FIGRANIUM_API_KEY=YOUR_API_KEY npx -y figranium-mcp

默认情况下，它会连接到 http://localhost:11345 上的 Figranium。若要使用其他实例：

FIGRANIUM_BASE_URL=https://your-figranium-instance.example.com \
FIGRANIUM_API_KEY=YOUR_API_KEY \
npx -y figranium-mcp

MCP 客户端配置

大多数本地 MCP 客户端接受如下格式的配置：

{
  "mcpServers": {
    "figranium": {
      "command": "npx",
      "args": ["-y", "figranium-mcp"],
      "env": {
        "FIGRANIUM_BASE_URL": "http://localhost:11345",
        "FIGRANIUM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

在 Codex、Claude Code、Cursor、GitHub Copilot、Claude Desktop、Cline 及其他 STDIO MCP 客户端中使用此服务条目。

如果 MCP 服务本身在 Docker 中运行，而 Figranium 在主机上运行，请使用 http://host.docker.internal:11345，而不是 http://localhost:11345。

Agent 可以做什么

连接后，Agent 无需手动调用 Figranium API 即可开展工作。MCP 服务提供了用于核心任务生命周期的工具：

工具	用途
task_list	发现现有任务
create_task	创建新任务
task_execute	执行任务，可选覆盖变量
execution_list	检查之前的执行记录
schedule_list	查找已安排的任务
schedule_get_all_status	检查调度器状态
schedule_get_status	检查单个任务的调度状态
schedule_set	创建或更新调度
schedule_delete	删除调度
schedule_describe	验证并预览调度

此服务还提供 figranium://schemas/task-v1.json，让客户端可以直接查看 Figranium 任务架构。

Figranium 的 MCP 指令会教 Agent 如何构建任务、选择选择器、使用变量并遵循任务排序规则。无效的任务负载会返回结构化验证诊断信息，便于 Agent 修正请求。

本地 MCP 与托管式 MCP

npm 包包含本地 STDIO MCP 服务，不包含 Figranium MCP 落地页或托管式 OAuth 界面。

对于支持远程 OAuth MCP 的客户端，请使用：

https://mcp.figranium.dev/mcp

托管式 MCP 负责处理 OAuth，并将客户端连接到可公开访问的 Figranium 实例。对于本地客户端，npx -y figranium-mcp 通常是更简单的选择，并且可以直接连接到 localhost。

环境变量

变量	必填	默认值	描述
FIGRANIUM_API_KEY	是	—	由你的 Figranium 实例生成的 API 密钥
FIGRANIUM_BASE_URL	否	http://localhost:11345	Figranium 实例的基础 URL

如果缺少 FIGRANIUM_API_KEY，服务会显示设置提示并退出。

从源代码构建

需要 Node.js 18+ 和 npm 9+。

git clone https://github.com/figranium/figranium-mcp.git
cd figranium-mcp
npm install
npm run build

运行编译后的服务：

FIGRANIUM_API_KEY=YOUR_API_KEY npm start

进行主动开发：

npm run watch

运行测试套件：

npm test

MCP Inspector

你可以使用官方 MCP Inspector 检查已发布的服务：

FIGRANIUM_API_KEY=YOUR_API_KEY npx @modelcontextprotocol/inspector npx -y figranium-mcp

Links

• Figranium documentation
• Figranium
• npm package
• MCP server source
• Figranium source