Documentero

Name: Documentero
Author: documentero

本地服务

documentero.com生产力114 周前更新

代码仓库访问官网

关于 Documentero

Documentero 是供 Agent 使用 Documentero 模板生成 Word、PDF 或 Excel 文件的 MCP 服务。它通过一组工具提供模板查找、字段架构检查和文档生成。

主要功能

01列出可用模板
02检查模板字段和 JSON Schema
03生成 Word 或 PDF 文档
04生成 Excel 文档
05返回签名链接或嵌入式 base64

适用场景

01为文档任务查找模板
02按模板架构整理数据
03根据模板字段生成文件
04选择下载链接或嵌入式输出

MCP 相关

向 MCP 客户端提供 Documentero 模板列表、字段检查和文件生成工具。此版本通过 stdio 运行，并使用 Documentero API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "documentero-documentero": {
      "command": "npx",
      "args": [
        "-y",
        "@documentero/mcp"
      ],
      "env": {
        "DOCUMENTERO_API_KEY": "<DOCUMENTERO_API_KEY>",
        "DOCUMENTERO_BASE_URL": "<DOCUMENTERO_BASE_URL>"
      }
    }
  }
}

启动命令npx -y @documentero/mcp

需要配置的环境变量

DOCUMENTERO_API_KEY密钥Company API key from Documentero Account settings

DOCUMENTERO_BASE_URLOptional Cloud API base URL (default: https://app.documentero.com/api)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@documentero/mcp0.1.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@documentero/mcp

Documentero 的官方 MCP 服务，可供 AI Agent（Cursor、Claude Desktop 等）列出模板、查看字段架构，并生成 Word/PDF/Excel 文档。

npm： @documentero/mcp
源代码： github.com/documentero/documentero-mcp
网站： documentero.com
文档： docs.documentero.com

工具

工具	描述
`list_templates`	列出带有 `kind`（word\|excel）、`defaultFormat`、`allowedFormats` 的模板
`get_template_fields`	JSON Schema（主要架构，包含扩展值规则）+ 字段定义 + 允许的格式
`generate_document`	根据指定模板和字段生成 Word/PDF 或 Excel 文档；默认提供签名 URL（约 1 小时有效），也可在 `embed: true` 时返回 base64。`format` 为可选项（默认使用模板格式）。

设置

从 Documentero → Account settings 复制 API 密钥。
在客户端配置中添加 MCP 服务。

Cursor / Claude Desktop（npx）

{
  "mcpServers": {
    "documentero": {
      "command": "npx",
      "args": ["-y", "@documentero/mcp"],
      "env": {
        "DOCUMENTERO_API_KEY": "your-api-key"
      }
    }
  }
}

本地开发

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

{
  "mcpServers": {
    "documentero": {
      "command": "node",
      "args": ["/absolute/path/to/documentero-mcp/dist/index.js"],
      "env": {
        "DOCUMENTERO_API_KEY": "your-api-key",
        "DOCUMENTERO_BASE_URL": "https://app.documentero.com/api"
      }
    }
  }
}

开发环境使用 https://documentero-dev.web.app/api。

环境变量

变量	必需	默认值	描述
`DOCUMENTERO_API_KEY`	是	—	公司 API 密钥（Account settings）
`DOCUMENTERO_BASE_URL`	否	`https://app.documentero.com/api`	云 API 基础 URL

典型 Agent 工作流

list_templates → 选择一个 templateId（遵循 kind / allowedFormats）
get_template_fields → 根据 jsonSchema 构造 data（使用 fieldDefinitions 获取 HTML/Markdown/图片/链接/QR 规则等补充信息）
generate_document → 获取下载 URL（或嵌入的 base64）

冒烟测试

npm run build
DOCUMENTERO_API_KEY=your-key npm run smoke

备注

这是公共云 API（/api/templates、/api/meta、/api/generate）的轻量客户端。Documentero 按常规方式执行配额和速率限制。
请勿将 API 密钥放入工具参数中——仅将其保存在 MCP 环境变量中。
Word 模板支持的输出格式：docx / pdf；Excel 模板仅支持 xlsx 输出格式。
计划支持远程 Streamable HTTP 托管（https://mcp.documentero.com/mcp）；此版本仅支持 stdio。