MCP 集成

阅读约 1 分钟

folio 提供一个 stdio MCP server，让 agent（Claude Code、Cursor、Cline、n8n）直接调用。

一行装

在你的 MCP 配置（如 ~/.claude/mcp.json 或项目 .mcp.json）添加：

{
  "mcpServers": {
    "folio": {
      "command": "npx",
      "args": ["-y", "@foliolang/cli"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-...",
        "ZHIPU_API_KEY": "..."
      }
    }
  }
}

重启 agent 客户端，4 个 tool 立即可用。

4 个 tool

folio_build

输入：

字段 类型 必填 说明
source string yes markdown 源
theme “default” | “academic” | “minimal” no 主题
inline boolean no 是否把 asset 都 inline 进单 HTML

输出 { html, errors[], warnings[], cost }。

folio_publish

像 folio_build 但发布到配置的 target（cloudflare / github / netlify / s3），返回 URL。

folio_list_providers

返回当前 env 配好的所有 LLM / image / publish provider 清单。agent 自检"我能用哪些"。

folio_extract

反向：从已生成的 HTML 抽出结构化数据（标题、章节列表、表格、图表）。供 agent 多轮处理。

典型 agent 工作流

No chat provider configured for lib-mode build

后续