mcpField
E
easydocforms

easydocforms

已认证精选本地服务
easydocforms.com健康医疗010 周前更新
代码仓库访问官网

关于 easydocforms

easydocforms 是面向医疗机构的 MCP 服务，可将空白 PDF 入院表单转换为托管填写链接，并获取完成后的 PDF。患者回答留在服务端，Agent 上下文仅接收提交元数据和答案数量。

主要功能

  1. 01导入空白 PDF 并轮询处理状态
  2. 02列出机构表单模板
  3. 03生成患者填写链接
  4. 04获取不含回答的提交元数据
  5. 05生成短时有效的 PDF 下载链接

适用场景

  1. 01将新患者表单转为在线填写流程
  2. 02把填写链接发送给患者
  3. 03检查表单提交是否完成
  4. 04获取可交给人工或 EMR 的完成版 PDF

MCP 相关

它以 stdio 方式运行 MCP 服务，通过工具连接 EasyDocForms Partner API。导入、模板、填写链接、提交元数据和完成版 PDF 链接均以 MCP 工具提供；患者答案不会返回给 Agent。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "easydocforms": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "EASYDOCFORMS_API_KEY",
        "-e",
        "EASYDOCFORMS_BASE_URL",
        "ghcr.io/easydocforms/easydocforms-mcp:0.1.2"
      ],
      "env": {
        "EASYDOCFORMS_API_KEY": "<EASYDOCFORMS_API_KEY>",
        "EASYDOCFORMS_BASE_URL": "<EASYDOCFORMS_BASE_URL>"
      }
    }
  }
}
启动命令docker run -i --rm -e EASYDOCFORMS_API_KEY -e EASYDOCFORMS_BASE_URL ghcr.io/easydocforms/easydocforms-mcp:0.1.2
需要配置的环境变量
EASYDOCFORMS_API_KEY密钥EasyDocForms Partner API key (edfk_live_*), created under Settings → Integrations → Partner API
EASYDOCFORMS_BASE_URLOptional API base URL override

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

安装包
ocighcr.io/easydocforms/easydocforms-mcp:0.1.2

工具

还没有获取到工具列表

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

详细介绍

easydocforms-mcp

CI

面向医疗患者登记表的 MCP 服务：赋予 AI Agent 将空白 PDF 登记表转换为托管式、适配移动设备的可填写表单的能力，向患者提供链接，并取回已填写完成、像素级精确的 PDF — 全程不会有任何 PHI 进入 Agent 的上下文。

此服务基于 EasyDocForms 构建。其文档理解流程（字段检测、复选框语义、同意书区块、签名模型）已在生产环境中用于医疗患者登记。此服务通过 easydocforms-go SDK 封装了 Partner API。

PHI 边界（请先阅读）

此服务的设计确保受保护的健康信息绝不会经过模型：

  • 仅导入空白表单。 import_pdf_from_url 要求 blank_form_attestation: true，并且接收 URL，绝不接收文档字节。
  • get_submission 返回元数据和答案数量 — 绝不返回患者的答案。 答案保留在服务端，由你的 API 密钥保护。
  • get_completed_pdf_link 返回有效期约 10 分钟的签名 URL，Agent 可以将其交给人工或 EMR，而不会暴露你的 API 密钥。请像对待传真一样谨慎处理。
  • external_ref 绝不能包含 PHI — 它是一个不透明的关联 ID（你的就诊或医嘱编号）。

工具

工具功能
import_pdf_from_url导入空白 PDF 登记表（异步；需要空白表单声明）
get_import_status轮询导入状态，直到模板就绪
list_templates列出组织启用的表单模板
create_fill_link生成托管 URL，供患者填写表单
get_submission提交元数据 + 答案数量 — 绝不返回答案
get_completed_pdf_link已完成 PDF 的短时有效签名下载 URL

安装

go install github.com/easydocforms/easydocforms-mcp/cmd/easydocforms-mcp@latest

你需要从 EasyDocForms 应用获取 API 密钥：Settings → Integrations → Partner API（仅显示一次）。

或者运行 Docker 镜像（无需 Go 工具链）：

docker run -i --rm -e EASYDOCFORMS_API_KEY=edfk_live_... ghcr.io/easydocforms/easydocforms-mcp:latest
Claude Code
claude mcp add easydocforms --env EASYDOCFORMS_API_KEY=edfk_live_... -- easydocforms-mcp
Claude Desktop（或任何 MCP 客户端）
{
  "mcpServers": {
    "easydocforms": {
      "command": "easydocforms-mcp",
      "env": { "EASYDOCFORMS_API_KEY": "edfk_live_..." }
    }
  }
}
环境
变量必需用途
EASYDOCFORMS_API_KEY是edfk_live_* Partner API 密钥
EASYDOCFORMS_BASE_URL否覆盖 API 基础 URL

试用

使用 MCP Inspector：

EASYDOCFORMS_API_KEY=edfk_live_... npx @modelcontextprotocol/inspector easydocforms-mcp

典型的 Agent 会话：“导入 https://clinic.example.com/forms/new-patient.pdf 上的登记表（它是空白的），然后给我一个就诊编号为 8675309 的填写链接。” Agent 会导入表单、轮询状态、使用 external_ref: "visit-8675309" 生成链接，并返回 URL。患者提交后，“那个就诊的 PDF 准备好了吗？” → get_submission + get_completed_pdf_link。

传输

仅支持 stdio，凭据来自环境变量 — 符合 MCP 规范针对本地运行服务的指导。计划在第二阶段推出托管式远程版本（Streamable HTTP + OAuth 2.1）。

开发

go test ./... -race

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。