关于 DrillFlow
DrillFlow 的 MCP 服务可将 Mermaid 流程图转换为可逐层进入的层级图,并发布为只读分享链接。适合通过 Agent 创建、分享和读取可导航图表的场景。
主要功能
- 01发布 DrillFlow 文档
- 02转换并发布 Mermaid 流程图
- 03将子图转换为可进入的子流程
- 04读取已发布图表
适用场景
- 01把 Mermaid 流程图发布为交互式层级图
- 02向他人分享只读图表链接
- 03读取已有的 DrillFlow 图表
MCP 相关
它向 MCP 客户端提供发布 DrillFlow 文档、转换并发布 Mermaid 图表以及读取已发布图表的工具。发布前需由宿主请求确认;生成的链接为公开只读链接。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y drillflow-mcpDRILLFLOW_TOKEN密钥A DrillFlow API token (Pro). Without it the server still publishes, but anonymously: the link is unowned, unlistable and expires after 72 hours, and every result says when.DRILLFLOW_API_URLOverride the API origin. Defaults to https://api.drillflow.de; only useful against staging.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
3收录的工具列表 · 更新于 2 天前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| document | object | 是 | 完整的 DrillFlow 文档对象(id、title、rootDiagramId、diagrams)。 |
详细介绍
drillflow-mcp
自动生成。请勿在此处编辑。 本仓库中的所有文件都会在每次发布时从 DrillFlow 源代码仓库复制;在此处所做的更改会在下次同步时被覆盖。请提交 issue,而非 pull request。
一个适用于 DrillFlow 的 MCP 服务——这是一款围绕逐层深入构建的图表编辑器,节点可以包含完整的子图,供你深入查看。
借助此服务,Agent 可以将 Mermaid 流程图转换为真正的分层图表,发布为可分享的只读链接,并读取已发布的图表。每个 subgraph 都会变成读者可以实际打开的子流程,这是扁平图片无法做到的。
安装
Claude Desktop(claude_desktop_config.json)或任意 MCP 宿主:
{
"mcpServers": {
"drillflow": {
"command": "npx",
"args": ["-y", "drillflow-mcp"],
"env": { "DRILLFLOW_TOKEN": "dfp_…" }
}
}
}
Claude Code:
claude mcp add drillflow --env DRILLFLOW_TOKEN=dfp_… -- npx -y drillflow-mcp
需要 Node 20 或更高版本。
工具
| 工具 | 功能 |
|---|---|
publish_diagram | 发布 DrillFlow 文档,并返回分享链接。 |
publish_mermaid | 转换 Mermaid 流程图(将子图转换为子流程)并发布。 |
read_diagram | 将已发布的图表作为文档读取;可使用分享链接、@handle/name 地址或 slug。 |
发布后,图表会显示在公开的只读链接中,任何持有链接的人都可以打开。未经宿主事先询问,不会发布任何内容。
配置
| 变量 | 含义 |
|---|---|
DRILLFLOW_TOKEN | 来自 app.drillflow.de 中你的账户 → API 令牌的 API 令牌。可选。 |
DRILLFLOW_API_URL | 默认为 https://api.drillflow.de。 |
未提供令牌时,服务会以匿名方式发布,并在每次结果中说明:链接无人拥有,无法列出或撤销,且会在 72 小时后失效(结果中会注明确切时间)。提供令牌后,链接将归属于你的账户——可在我的分享链接中查看、重命名和撤销,且永不过期。
格式
文档格式见 https://drillflow.de/en/format/,JSON Schema 见 https://drillflow.de/schema/drillflow-document.schema.json。此外,还有一个用于生成 DrillFlow 图表的 Claude Skill: capydev42/drillflow-skill。
构建
本仓库包含服务自身的源代码,以下 MIT 许可证适用于这些代码。本项目无法独立构建:软件包包含了 DrillFlow 编辑器(闭源)中的几个模块——Mermaid 导入器和文档验证器——因此,发布到 npm 的 drillflow-mcp 是从 DrillFlow 仓库构建的,而非从此处构建。请使用 npx 安装;在此处阅读代码。
许可证
MIT——详见 LICENSE。此许可证适用于本仓库中的 MCP 服务,不适用于 DrillFlow 应用程序。
问题反馈
欢迎在本仓库的 issue 跟踪器中报告错误,也可发送邮件至 [email protected]。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。