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
日志包含以下信息：
- 文件上传记录
- 文件状态查询记录
- 错误信息
注意事项
- 文件大小限制：
- 总大小不超过 50MB - 单页内容不超过 20MB
- 文件名要求：
- 不能包含特殊字符：/ \\ : * " | ？ - 不能包含 emoji 表情 - 扩展名必须与实际文件格式一致
- 环境说明：
- 测试/沙箱环境：用于开发测试 - 正式环境：用于生产部署
错误处理
工具会自动处理常见错误情况：
- 文件格式不支持
- 文件上传失败
- 文件转换失败
- 签署流程创建失败
所有错误都会记录在日志文件中，并返回详细的错误信息。
License
MIT