Napkin

@mindstone/mcp-server-napkin

面向 Model Context Protocol 宿主的 Napkin AI 视觉生成 MCP 服务。通过文本描述生成专业视觉内容——图表、信息图和插图；检查生成状态，并通过标准化的 MCP 接口下载结果。

状态

• 版本： 0.4.1 · npm
• 身份验证： API 密钥（NAPKIN_API_KEY）
• 工具： 5（视觉内容、下载、样式）
• 接口： cloud-api
• 机器可读： STATUS.json

注意： Napkin API 目前处于开发者预览版（参见 api.napkin.ai）。端点和行为可能发生变化；请将上游问题报告至 [email protected]。较早的指南中提到了 context_before/context_after 参数——Napkin 已弃用这些参数，改用单个 context 参数，napkin_generate_visual 支持该参数。

要求

• Node.js 20+
• npm

一键安装

点击按钮后，宿主会提示你填写：NAPKIN_API_KEY、NAPKIN_REQUEST_TIMEOUT_MS。

{
  "mcpServers": {
    "Napkin": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-napkin"
      ],
      "env": {
        "NAPKIN_API_KEY": "",
        "NAPKIN_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

快速开始

安装和构建

cd <path-to-repo>/connectors/napkin
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-napkin

本地

node dist/index.js

配置

环境变量

• NAPKIN_API_KEY — Napkin AI API 密钥
• MCP_WORKSPACE_PATH — 用于保存生成的视觉内容的可选工作区路径
• MCP_HOST_BRIDGE_STATE — 用于凭据管理的宿主桥接状态文件的可选路径
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE 的向后兼容别名
• NAPKIN_REQUEST_TIMEOUT_MS — 可选的超时覆盖值（正整数，单位为 ms，最长 30 min），适用于发往 Napkin API 的出站 HTTP 请求、宿主桥接请求和下载请求。默认值：60000（60s）。如果慢速提交或大型下载出现 TIMEOUT 错误，请调高此值；如果希望缩短超时限制，请调低此值。

宿主配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Napkin": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-napkin"],
      "env": {
        "NAPKIN_API_KEY": "your-api-key"
      }
    }
  }
}

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "Napkin": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/napkin/dist/index.js"],
      "env": {
        "NAPKIN_API_KEY": "your-api-key"
      }
    }
  }
}

工具（5 个）

配置

• configure_napkin_api_key — 配置 Napkin AI API 密钥

生成

• napkin_generate_visual — 根据文本生成专业视觉内容
• napkin_check_status — 检查视觉内容生成请求的状态（供应商编写的自由文本——警告/错误消息和 visual_query——会封装在 <untrusted-content> 信封中，以便主机将其视为数据；代码、ID 和 URL 保持原样，并通过响应验证强制执行其机器标识符字符集）
• napkin_download_visual — 将生成的视觉内容文件下载到磁盘（绝不覆盖已有文件——请传入不同的 filename，或省略该参数以自动生成文件名）。重定向会在跟进前根据 Napkin 主机允许列表重新验证；不在允许列表中的重定向目标将被拒绝。

样式

• napkin_list_styles — 列出 Napkin 内置的 15 种视觉样式（ID、描述、类别），以便为 napkin_generate_visual 选择 style_id。静态目录；无需 API 密钥或网络调用。

许可

FSL-1.1-MIT — Functional Source License，第 1.1 版，未来将采用 MIT 许可。该软件将于 2030-04-08 转为 MIT 许可。