trackmcp
Back to directory
esign-cn-open-source

mcp-server-esign

View on GitHub

mcp-server-esign

0 stars JavaScriptServers & Infrastructure Updated May 28, 2025

Documentation

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 配置中添加以下环境变量:

json
{
  "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`: 签署人手机号

示例:

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

2. query_sign_flow

查询签署流程详情。

参数:

  • `flowId`: 签署流程ID

示例:

json
{
  "flowId": "12345678"
}

日志

日志文件位置:`/tmp/app.log`

日志包含以下信息:

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

注意事项

1. 文件大小限制:

    2. 文件名要求:

      3. 环境说明:

        错误处理

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

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

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

        License

        MIT

        相关链接

        Frequently asked questions

        What is mcp-server-esign?

        mcp-server-esign is mcp-server-esign

        How do I install mcp-server-esign?

        Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

        Is mcp-server-esign open source?

        Yes — it is hosted on GitHub at https://github.com/esign-cn-open-source/mcp-server-esign.

        Related MCP tools

        Run your own MCP server? See who uses it and what to fix.

        Measure it with TrackMCP