home / mcp / esign mcp server

Esign MCP Server

Provides an MCP-based tool to upload documents, convert to PDF, create signing flows, and query signing status.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "esign-cn-open-source-mcp-server-esign": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-esign@{version}"
      ],
      "env": {
        "HOST": "选择对应环境： 测试环境/ 沙箱环境/ 正式环境：https://openapi.esign.cn",
        "APP_ID": "YOUR_APP_ID",
        "APP_SECRET": "YOUR_APP_SECRET"
      }
    }
  }
}

You use the MCP server to upload documents, create signing flows, and check signing statuses. This MCP-based tool automates file handling, converts various formats to PDF, and provides end-to-end signing workflow capabilities with complete logging and status checks.

How to use

Set up and run the MCP server, then interact with it using an MCP client. You can upload documents in multiple formats, have them automatically converted to PDF, create signing flows for recipients, and query the status and details of those flows. All actions are logged for troubleshooting and auditing.

How to install

# Prerequisites
- Install Node.js (recommended LTS version)
- Ensure npm is available

# 1. Install the MCP server tool and start it
# This starts the server using npx with the MCP package
npx -y mcp-server-esign@{version}

Additional configuration and usage notes

Configuration for running the MCP server is done via environment variables. You explicitly set the host environment and credentials to connect to the signing service.

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

日志与注意事项

日志记录在 /tmp/app.log，包含文件上传记录、文件状态查询记录和错误信息。请在出现问题时检查该日志以定位原因。

注意事项包括文件大小限制、文件名约束和环境选择：总大小不超过 50MB，单页不超过 20MB；文件名不能包含特殊字符、emoji，且扩展名需与实际格式一致；测试/沙箱环境用于开发测试，正式环境用于生产。

错误处理与支持

工具会自动处理常见错误，如文件格式不支持、上传失败、转换失败或签署流程创建失败。所有错误都会记录在日志中，并返回详细的错误信息。

日志文件位置

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

License and links

MIT 许可，相关链接指向 e签宝开放平台文档与 Model Context Protocol。

Available tools

create_sign_flow

Creates a signing workflow for a document, supporting multiple file formats and recipients.

query_sign_flow

Queries the details of a signing workflow by its flow ID, returning status and participant information.