mcpField
E
Esign MCP

Esign MCP

本地服务
github.com/esign-cn-open-source生产力274 周前更新
代码仓库

关于 Esign MCP

Esign MCP 是面向 e签宝电子签署流程的 MCP 服务，支持上传文档并转换为 PDF、创建签署流程，以及查询流程详情。

主要功能

  1. 01上传本地文件或远程文件链接
  2. 02将支持的格式转换为 PDF
  3. 03创建电子签署流程
  4. 04查询签署流程详情
  5. 05记录操作日志

适用场景

  1. 01从合同文件创建签署流程
  2. 02查看已有签署流程的详情

MCP 相关

向 MCP 客户端提供创建 e签宝签署流程和查询流程详情的工具。创建流程时，服务负责文档上传与格式转换。

#esign#e-signature#document-signing#mcp-tool

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "esign-cn-open-source_mcp-server-esign": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-esign"
      ],
      "env": {
        "HOST": "<HOST>",
        "APP_ID": "<APP_ID>",
        "APP_SECRET": "<APP_SECRET>"
      }
    }
  }
}
启动命令npx -y mcp-server-esign
需要配置的环境变量
HOST
APP_ID
APP_SECRET密钥

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

安装包
npmmcp-server-esign

工具

还没有获取到工具列表

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

详细介绍

来自项目 README

e签宝 MCP 工具

基于 Model Context Protocol (MCP) 的 e签宝电子签署工具，支持文件上传、签署流程创建、签署状态查询等功能。

功能特点

  • 支持多种文件格式上传和自动转换为 PDF(支持本地文件路径和远程文件下载链接)：
    • PDF 文件（.pdf）
    • Word 文件（.docx, .doc, .rtf）
    • Excel 文件（.xlsx, .xls）
    • PowerPoint 文件（.pptx, .ppt）
    • WPS 文件（.wps, .et, .dps）
    • 图片文件（.jpeg, .jpg, .png, .bmp, .tiff, .tif, .gif）
    • HTML 文件（.html, .htm）
  • 自动文件状态检查，确保文件处理完成
  • 支持创建签署流程
  • 支持查询签署流程详情
  • 完整的日志记录

配置

在 MCP 配置中添加以下环境变量：

{
  "esign-mcp": {
    "command": "npx",
    "args": ["-y", "mcp-server-esign@{version}"],
    "env": {
      "HOST": "选择对应环境：",
      "  - 测试环境：",
      "  - 沙箱环境：",
      "  - 正式环境：https://openapi.esign.cn",
      "APP_ID": "你的应用ID",
      "APP_SECRET": "你的应用密钥"
    }
  }
}

可用工具

1. create_sign_flow

创建签署流程，支持多种文件格式。

参数：

  • filePath: 本地文件路径
  • fileName: 文件名（必须包含正确的文件扩展名）
  • receiverPhone: 签署人手机号

示例：

{
  "filePath": "/path/to/contract.pdf",
  "fileName": "合同.pdf",
  "receiverPhone": "138****8000"
}
2. query_sign_flow

查询签署流程详情。

参数：

  • flowId: 签署流程ID

示例：

{
  "flowId": "12345678"
}

日志

日志文件位置：/tmp/app.log

日志包含以下信息：

  • 文件上传记录
  • 文件状态查询记录
  • 错误信息

注意事项

  1. 文件大小限制：

    • 总大小不超过 50MB
    • 单页内容不超过 20MB

  2. 文件名要求：

    • 不能包含特殊字符：/ \ : * " < > | ？
    • 不能包含 emoji 表情
    • 扩展名必须与实际文件格式一致

  3. 环境说明：

    • 测试/沙箱环境：用于开发测试
    • 正式环境：用于生产部署

错误处理

工具会自动处理常见错误情况：

  • 文件格式不支持
  • 文件上传失败
  • 文件转换失败
  • 签署流程创建失败

所有错误都会记录在日志文件中，并返回详细的错误信息。

License

MIT

相关链接

评论

支持 Markdown

第一次接触 MCP？

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

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