🚀 Signaturit MCP 服务端签名 ✍️
本项目演示了一个 MCP（微服务通信协议）服务器如何通过 Signaturit 工具的公共 API 进行整合，可提供多种功能来管理签名请求，包括列表、创建和处理签名。
⚠️ 重要提示
这是一个非官方集成项目，与 Signaturit 无任何关联、无正式维护或支持。
🚀 快速开始
本项目需要满足一定的先决条件，完成配置和构建后，即可运行 MCP 服务器。具体步骤如下：
- 配置 API 认证：在 Signaturit 创建账户，获取 API 密钥，并将其设置为环境变量。
- 满足先决条件：安装 Go 1.16 或更高版本，并在 Signaturit 拥有活动账户和有效的 API 密钥。
- 构建项目：克隆仓库、安装依赖项、构建应用程序，并运行构建好的二进制文件。
具体操作请参考下文的“配置”、“先决条件”和“构建”部分。
✨ 主要特性
MCP 服务器提供以下工具与 Signaturit 交互：
- get_signature 📄：使用签名请求 ID 获取特定签名请求的详细信息。
- create_signature ✨：使用模板创建新的签名请求，具备以下特点：
- 支持多个签署人 👥。
- 通过电子邮件或短信发送 📧 📱。
- 可自定义的过期时间 ⏰。
- 串行或并行签署流程 ⛓️。
- 自定义电子邮件/短信消息 💬。
- 网钩集成以实现实时通知 🔔。
- send_signature_reminder 📬：发送提醒通知给待处理的签署人。
- cancel_signature ❌：取消活动签名请求并可自选原因。
📦 安装指南
配置 ⚙️
API 认证 🔐
此服务器与 Signaturit API 集成，需要一个 API 密钥进行身份验证。您需要：
- 在 Signaturit 创建账户。
- 从 Signaturit 仪表盘获取您的 API 密钥。
- 将 API 密钥设置为环境变量：
export SIGNATURIT_SECRET_TOKEN='your_api_key_here'
先决条件 📋
- Go 安装
- Go 1.16 或更高版本。
- 验证安装：
go version
- Signaturit 账户
- 在 Signaturit 拥有活动账户。
- 有效的 API 密钥，从 Signaturit 仪表盘获取。
构建 🔨
- 克隆仓库
git clone https://github.com/yourusername/signaturtit_mcp.git cd signaturtit_mcp - 安装依赖项
go mod download - 构建应用程序
# 为当前平台构建 go build -o bin/signaturtit_mcp cmd/server/main.go # 为特定平台构建（例如 Linux） GOOS=linux GOARCH=amd64 go build -o bin/signaturtit_mcp cmd/server/main.go - 运行构建好的二进制文件
# 确保您已经设置了所需的环境变量 export SIGNATURIT_SECRET_TOKEN='your_api_key_here' # 运行应用程序 ./bin/signaturtit_mcp
📚 详细文档
项目结构 📁
- cmd/server/main.go 🎯：应用程序入口。负责初始化并启动 MCP 服务器。
- internal/app/server.go ⚙️：包含创建和配置 MCP 服务器的逻辑，包括注册签名工具和服务处理。
- internal/handlers/signature.go 🛠️：实现各种签名操作（如列表、获取、管理）的处理程序。
- internal/tools/signature.go 🔧：将签名相关的工具注册到 MCP 服务器。
📄 许可证
版权 2024 Jordi Martin
根据 Apache 许可证 2.0（"许可证"）的条款，您可以在符合条件的情况下使用此文件；否则，不得使用该文件。
您可以从以下链接获取许可证：
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面协议另有约定，否则软件
在本许可下分发是按“原样”提供的，不附带任何形式的担保或其他条件。
有关具体条款，请参阅许可证中指定的语言。