关于 Doconda
Doconda 的 MCP 服务让 AI Agent 创建、审阅和编辑 Word、PowerPoint、Excel 与 PDF 文档。它提供可编辑文件,并附带 PDF 和逐页预览,便于交付前检查。
主要功能
- 01创建 Word、PowerPoint、Excel 和 PDF 文件
- 02审阅和编辑文档
- 03上传和获取文件
- 04读取制品数据与报告
- 05提供 PDF 和逐页预览
适用场景
- 01生成 Excel 活动预算
- 02审阅并修改 Word 文档
- 03根据 Agent 请求创建演示文稿或 PDF
MCP 相关
向 MCP 客户端提供文档创建、上传、审阅、编辑、检索、报告及制品读取工具。可通过远程 Streamable HTTP 服务或本地 stdio 服务使用。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.eu.doconda.com/mcpclaude mcp add --transport http com-doconda https://api.eu.doconda.com/mcp{"mcpServers":{"com-doconda":{"type":"http","url":"https://api.eu.doconda.com/mcp"}}}在 Cursor 中打开{"servers":{"com-doconda":{"type":"http","url":"https://api.eu.doconda.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-doconda":{"type":"http","url":"https://api.eu.doconda.com/mcp"}}}{"mcpServers":{"com-doconda":{"serverUrl":"https://api.eu.doconda.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://api.eu.doconda.com/mcp需要授权工具
8| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data | enum | 否 | 仅适用于 Artifacts。shared(默认):拥有链接的所有人都能看到相同数据(投票、团队列表)。local:每位访问者的数据仅保存在其浏览器中(计算器、个人清单)。retention 为 none 时,仅支持 local。shared | local |
| name | string | 否 | 可选:为文档命名,方便日后查找,例如 'Contrato piso Malasaña'。文件也会使用此名称。 |
| style | string | 否 | 可选:用简单文字描述外观,例如 'blue centred headings, Lora font, page numbers, table of contents'。 |
| format | enum | 否 | docx → Word(+ PDF);pdf → 仅 PDF;pptx → PowerPoint(+ PDF);xlsx → Excel(+ PDF);artifact → 网页。如果用户未指定,请省略,由 Doconda 根据 prompt 决定。docx | pdf | pptx | xlsx | artifact |
| prompt | string | 否 | 要撰写的内容,使用用户自己的措辞(主题、受众、篇幅、语气)。也可提出格式要求,例如 'blue centred headings, with a cover page'。 |
| markdown | string | 否 | 已写好的 Markdown 内容(替代 prompt)。对于 artifact,即页面上显示的内容。 |
| retention | enum | 否 | 可选:Doconda 完成后保留文档的时长(none = 15 分钟)。如果不指定,则使用项目的保留期限(除非更改,否则为 30 天)。用户应在此期限前保存文件。none | 1d | 7d | 30d | 90d |
| source_file_ids | array | 否 | 已上传的文件(upload_file)或已创建的文档(其 ID 来自 list_documents):作为文本依据的文档(最多 5 个,需提供提示词)以及要放入文档中的图片(最多 10 张;使用 Markdown 时,将它们引用为 ,表示第一张图片)。 |
详细介绍
@doconda/mcp
适用于 Doconda 的 MCP 服务:为你的 AI Agent 提供工具,用于创建、审阅和编辑 Word、PowerPoint、Excel 和 PDF 文档。交付前审阅可编辑文件,并附上 PDF 和每页预览。
远程服务(供应用的 Agent 使用)
无需安装:https://api.eu.doconda.com/mcp(Streamable HTTP,标头 Authorization: Bearer ak_eu_…)。任何支持 MCP 的 Agent 框架或模型 API 都能使用。搭配 OpenAI Responses API 使用:
from openai import OpenAI
response = OpenAI().responses.create(
model="gpt-5",
input="Make an Excel with the event budget",
tools=[{
"type": "mcp",
"server_label": "doconda",
"server_url": "https://api.eu.doconda.com/mcp",
"headers": {"Authorization": "Bearer ak_eu_…"},
"require_approval": "never",
}],
)
print(response.output_text)
消息(错误、报告文本)使用英语;远程服务会遵循 Accept-Language,因此可发送 Accept-Language: es 来使用西班牙语。
不使用 MCP?SDK 可为任何支持工具调用的模型提供相同的工具:@doconda/sdk · doconda。
本地服务(stdio)
使用 Claude Code:
claude mcp add --transport stdio doconda --env DOCONDA_API_KEY=ak_eu_… -- npx -y @doconda/mcp
对于其他 MCP 客户端,例如 Claude Desktop:
{
"mcpServers": {
"doconda": {
"command": "npx",
"args": ["-y", "@doconda/mcp"],
"env": { "DOCONDA_API_KEY": "ak_eu_…" }
}
}
}
工具
create_document、upload_file、review_document、edit_document、list_documents、get_document、get_report、
read_artifact_data。
文档:https://docs.doconda.com/en/agents/mcp · 示例:https://github.com/B-C-Software/doconda-examples · 获取 API 密钥:https://doconda.com
开发
Node 22.18 或更高版本:
npm install
npm run build
npm test
测试无需 API 密钥,也不会发起网络调用。本仓库从 Doconda 主仓库发布: 请在此处提交问题和拉取请求;已接受的更改会应用到上游,并在下次发布时推出。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。