Licensespring MCP

🚀 LicenseSpring® MCP Server

LicenseSpring® MCP Serverは、LicenseSpring APIと統合されたMCPサーバーの実装です。包括的なライセンス管理と顧客運用機能を提供します。

✨ 主な機能

• ライセンス操作：ハードウェアバインディングを伴うライセンスのアクティベート、チェック、ディアクティベート
• 顧客管理：顧客の作成、一覧表示、管理
• 使用状況追跡：ライセンスの消費と機能の使用状況を監視
• トライアル管理：トライアルライセンスの生成と管理
• フローティングライセンス：フローティングライセンスの操作を扱う
• 認証優先順位：主な認証方法としてLICENSE_API_KEYを使用し、LICENSE_SHARED_KEYはセキュリティ向上のためにオプションで使用可能
• 包括的なテスト：実際のAPIを使用した完全な統合テストスイート

📦 インストール

NPMパッケージ

npm install -g @tfedorko/licensespring-mcp-server

⚠️ 重要提示

最適な互換性のために、Node.js 20.x以上が必要です。

Dockerイメージ

# ライセンスAPIサーバー
docker pull stiertfedorko/licensespring-mcp:latest

# 管理APIサーバー
docker pull stiertfedorko/licensespring-mcp-management:latest

💻 使用例

ツール

License APIツール

• activate_license - ハードウェアIDをバインドしてライセンスをアクティベート
• check_license - ライセンスの状態と有効性をチェック
• deactivate_license - 特定のハードウェアのライセンスをディアクティベート
• add_consumption - ライセンスに消費ユニットを追加
• get_trial_key - トライアルライセンスキーを生成
• get_product_details - 製品情報を取得
• floating_release - フローティングライセンスを解放
• floating_borrow - オフラインで使用するためにフローティングライセンスを借用
• change_password - ユーザーベースのライセンスのユーザーパスワードを変更
• get_versions - 利用可能なソフトウェアバージョンを取得
• get_installation_file - インストールファイルの情報を取得
• get_sso_url - シングルサインオンURLを生成

管理APIツール

• list_licenses - オプションでフィルタリングしたライセンスを一覧表示
• create_license - 新しいライセンスを作成
• update_license - 既存のライセンスを更新
• get_license - 詳細なライセンス情報を取得
• delete_license - ライセンスを削除
• list_customers - フィルタリングオプションを持つ顧客を一覧表示
• create_customer - 新しい顧客を作成

設定

API資格情報の取得

1. ライセンスAPIキー：LicenseSpringダッシュボードにログイン → 設定 → キー（主な認証方法）
2. 管理APIキー：同じ場所から管理APIキーをコピー
3. 共有キー：共有API設定を使用する組織にとってオプション（セキュリティ向上）

テスト

機能を検証するために包括的な統合テストを実行します。

# プロジェクトをビルド
npm run build

# 実際のLicenseSpring APIに対して統合テストを実行
npm run test:integration

# 単体テストを実行
npm test

統合テストは、すべての34個のMCPツールを実際のLicenseSpring APIに対して検証し、認証の優先順位が正しく機能することを確認します。この実装は、LicenseSpringのPostmanコレクションと100％の機能互換性を提供します。

🔧 CI/CD統合：GitHub Actionsワークフローは、適切なシークレット設定で完全な統合テストをサポートしています。

Claude Desktopでの使用

claude_desktop_config.jsonに以下を追加します。

ライセンスAPIサーバー

{
  "mcpServers": {
    "licensespring": {
      "command": "npx",
      "args": [
        "-y",
        "@tfedorko/licensespring-mcp-server",
        "license-api"
      ],
      "env": {
        "LICENSE_API_KEY": "YOUR_LICENSE_API_KEY",
        "LICENSE_SHARED_KEY": "YOUR_SHARED_KEY_IF_USING_SHARED_API_SETTINGS"
      }
    }
  }
}

管理APIサーバー

{
  "mcpServers": {
    "licensespring-management": {
      "command": "npx",
      "args": [
        "-y",
        "@tfedorko/licensespring-mcp-server",
        "management-api"
      ],
      "env": {
        "MANAGEMENT_API_KEY": "YOUR_MANAGEMENT_API_KEY"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "licensespring": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "LICENSE_API_KEY",
        "-e",
        "LICENSE_SHARED_KEY",
        "stiertfedorko/licensespring-mcp:latest"
      ],
      "env": {
        "LICENSE_API_KEY": "YOUR_LICENSE_API_KEY",
        "LICENSE_SHARED_KEY": "YOUR_SHARED_KEY_OR_LEAVE_EMPTY"
      }
    },
    "licensespring-management": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MANAGEMENT_API_KEY",
        "stiertfedorko/licensespring-mcp-management:latest"
      ],
      "env": {
        "MANAGEMENT_API_KEY": "YOUR_MANAGEMENT_API_KEY"
      }
    }
  }
}

サブスクリプションレベルのサポート

サーバーは、あなたのLicenseSpringサブスクリプションレベルに自動的に適応します。

• プレミアム/エンタープライズ：HMAC認証を伴う完全な機能
• 基本/標準：アップグレードのアドバイス付きの制限モード
• 開発：安全な開発のためのテストモード

⚠️ 重要提示

LICENSE_SHARED_KEYはオプションです。サーバーはサブスクリプションレベルに関係なく起動し、APIの制限に関する適切なガイダンスを提供します。

VS Codeでの使用

すばやくインストールするには、以下のワンクリックインストールボタンを使用してください。

手動でインストールするには、VS Codeのユーザー設定（JSON）ファイルに以下のJSONブロックを追加します。

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "license_api_key",
        "description": "LicenseSpring License API Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "license_shared_key",
        "description": "LicenseSpring Shared Key (optional for Basic/Standard tiers)",
        "password": true
      }
    ],
    "servers": {
      "licensespring": {
        "command": "npx",
        "args": ["-y", "@tfedorko/licensespring-mcp-server", "license-api"],
        "env": {
          "LICENSE_API_KEY": "${input:license_api_key}",
          "LICENSE_SHARED_KEY": "${input:license_shared_key}"
        }
      }
    }
  }
}

📚 ドキュメント

トラブルシューティング

一般的な問題

エラー: "npm error could not determine executable to run"

• 解決策：バージョン1.0.1以上に更新します：npx @tfedorko/licensespring-mcp-server@latest
• 原因：v1.0.1で修正 - バイナリの設定と起動プロセスが改善

エラー: "MCP error -1: Connection closed"

• 解決策：バージョン1.0.2以上に更新します：npx @tfedorko/licensespring-mcp-server@latest
• 原因：v1.0.2で修正 - サーバーはClaude Desktopとの互換性のためにデフォルトでライセンスAPIモードになります

エラー: "LICENSE_API_KEY is required"

• 解決策：.envファイルまたはClaude Desktopの設定で環境変数を設定します
• 確認：.env.exampleを.envにコピーし、API資格情報を入力します

エラー: "Authentication failed"

• 解決策：LicenseSpringダッシュボードでAPIキーを確認します
• 注意：LICENSE_SHARED_KEYは基本/標準サブスクリプションレベルではオプションです

サーバーは起動するが、API呼び出しが失敗する

• 確認：LicenseSpringのサブスクリプションレベルと利用可能なAPI機能
• 解決策：サーバーはサブスクリプションの制限に関する有益なガイダンスを提供します

ヘルプの取得

1. エラーメッセージを確認 - 具体的なガイダンスが提供されています
2. LicenseSpringのサブスクリプションレベルとAPIアクセスを確認
3. 以下の高度なドキュメントを確認
4. エラーの詳細を含めてGitHubでイシューを作成

リリース自動化

このプロジェクトには、包括的な自動リリースバージョニングとNPM配布が含まれています。

クイックリリースコマンド

npm run release          # パッチリリース (1.0.0 -> 1.0.1)
npm run release:minor    # マイナーリリース (1.0.0 -> 1.1.0)
npm run release:major    # メジャーリリース (1.0.0 -> 2.0.0)

変更のプレビュー

npm run version:dry      # バージョンの更新をプレビュー
npm run publish:dry      # NPMの公開をプレビュー

自動化されたGitHubリリース

• コミットトリガー：コミットメッセージに[release]を使用
• 手動実行：GitHub Actionsワークフロー
• セマンティックリリース：従来のコミットメッセージ

完全な自動化ドキュメントについては、Release Automation Guide を参照してください。

高度なドキュメント

包括的なガイドと高度な設定については、以下を参照してください。

• Release Automation Guide - 完全な自動リリースと配布システム
• Subscription Tier Support - 異なるLicenseSpringサブスクリプションレベルの詳細ガイド
• Distribution Guide - 完全なセットアップと共有手順
• Test Report - 包括的なテスト結果と検証
• Migration Guide - 技術的な実装詳細

🔧 ビルド

Dockerビルド：

docker build -t licensespring-mcp:latest -f Dockerfile .
docker build -t licensespring-mcp-management:latest -f Dockerfile.management .

📄 ライセンス

このMCPサーバーはMITライセンスの下でライセンスされています。これは、MITライセンスの条件に従って、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリのLICENSEファイルを参照してください。

商標表示

このプロジェクトは、Cense Data Inc.からの許可を得てLicenseSpring®の名称を使用しています。詳細については、TRADEMARKファイルを参照してください。