Signaturit

🚀 Signaturit MCP サーバー署名 ✍️

このプロジェクトは、MCP（マイクロサービス通信プロトコル）サーバーが Signaturit ツールのパブリック API を介して統合される方法をデモンストレートしています。署名リクエストの管理に関するさまざまな機能を提供し、リストの表示、作成、署名の処理などが可能です。

⚠️ 重要提示

これは非公式の統合プロジェクトであり、Signaturit とは一切関係がなく、正式なメンテナンスやサポートは提供されていません。

🚀 クイックスタート

このプロジェクトは、MCP サーバーが Signaturit ツールのパブリック API を通じて統合される方法を示しています。以下の手順で、このサーバーを使用して署名リクエストを管理することができます。

✨ 主な機能

MCP サーバーは、以下のツールを提供して Signaturit とやり取りします。

• get_signature 📄: 署名リクエスト ID を使用して、特定の署名リクエストの詳細情報を取得します。
• create_signature ✨: テンプレートを使用して新しい署名リクエストを作成します。
  • 複数の署名者をサポート 👥
  • 電子メールまたは SMS で送信 📧 📱
  • カスタマイズ可能な有効期限 ⏰
  • シリアルまたはパラレルの署名フロー ⛓️
  • カスタマイズ可能な電子メール/SMS メッセージ 💬
  • リアルタイム通知を実現するための Webhook 統合 🔔
• send_signature_reminder 📬: 未処理の署名者にリマインダー通知を送信します。
• cancel_signature ❌: アクティブな署名リクエストをキャンセルし、理由を選択することができます。

📦 インストール

前提条件 📋

1. Go のインストール

   • Go 1.16 以上のバージョンが必要です。
   • インストールを確認するには、以下のコマンドを実行します。

     go version
     

2. Signaturit アカウント

   • Signaturit にアクティブなアカウントが必要です。
   • Signaturit ダッシュボードから有効な API キーを取得します。

API 認証 🔐

このサーバーは Signaturit API と統合されており、API キーを使用して認証する必要があります。以下の手順を実行してください。

1. Signaturit でアカウントを作成します。
2. Signaturit ダッシュボードから API キーを取得します。
3. API キーを環境変数として設定します。

export SIGNATURIT_SECRET_TOKEN='your_api_key_here'

プロジェクトの構築 🔨

1. リポジトリをクローンする

   git clone https://github.com/yourusername/signaturtit_mcp.git
   cd signaturtit_mcp
   

2. 依存関係をインストールする

   go mod download
   

3. アプリケーションをビルドする

   # 現在のプラットフォーム用にビルドする
   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
   

4. ビルドしたバイナリを実行する

   # 必要な環境変数を設定していることを確認してください
   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 サーバーに登録します。

📄 ライセンス

Copyright 2024 Jordi Martin

このファイルは、Apache ライセンス 2.0（「ライセンス」）の条件に従って使用することができます。それ以外の場合は、このファイルを使用することはできません。

ライセンスのコピーは以下の場所から入手できます。

    http://www.apache.org/licenses/LICENSE-2.0

適用される法律または書面による契約によって要求されない限り、このライセンスの下で配布されるソフトウェアは、明示または黙示を問わず、いかなる保証または条件も付されず、「現状のまま」提供されます。

具体的な条件については、ライセンスに指定された言語を参照してください。