Esign MCP
About
基于 Model Context Protocol (MCP) 的 e签宝电子签署工具,支持文件上传、签署流程创建、签署状态查询等功能。
Details
- Author
- esign-cn-open-source
- Downloads
- 376
- Categories
- Other
Jump to
- Supports multiple file formats auto‑converted to PDF.
- Automatically checks file processing status.
- Logs all operations to /tmp/app.log.
- Creates signing flows with a receiver phone number.
- Queries signing flow details by flow ID.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Esign MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server by setting the environment variables HOST, APP_ID, and APP_SECRET in your MCP client’s configuration, then run npx -y mcp-server-esign@{version}. Two tools are available: create_sign_flow (upload a local file and initiate a signing flow) and query_sign_flow (check the status of a flow by its ID).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"esign mcp": {
"esign-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-server-esign@{version}"
],
"env": {
"HOST": "https://openapi.esign.cn",
"APP_ID": "Your APP ID",
"APP_SECRET": "Your APP Secret"
}
}
}
}
}
McpServers
{
"esign-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-server-esign@{version}"
],
"env": {
"HOST": "https://openapi.esign.cn",
"APP_ID": "Your APP ID",
"APP_SECRET": "Your APP Secret"
}
}
}
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
相关链接
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



