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

💻 使用示例

工具介紹

許可證 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

集成測試會針對真實的 LicenseSpring API 驗證所有 34 個 MCP 工具，並驗證認證優先級是否正常工作。該實現與 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"
      }
    }
  }
}

與 VS Code 配合使用

一鍵安裝

使用以下一鍵安裝按鈕進行快速安裝：

手動安裝

將以下 JSON 塊添加到 VS Code 的用戶設置（JSON）文件中：

{
  "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}"
        }
      }
    }
  }
}

📚 詳細文檔

訂閱層級支持

服務器會自動適應您的 LicenseSpring 訂閱層級：

• 高級/企業版：具備 HMAC 認證的完整功能。
• 基礎/標準版：有限模式，提供有用的升級指導。
• 開發版：用於安全開發的測試模式。

注意：LICENSE_SHARED_KEY 是可選的。無論您的訂閱層級如何，服務器都會啟動，併為 API 限制提供適當的指導。

故障排除

常見問題

錯誤：“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 中修復 - 服務器現在默認以 license-api 模式運行，以兼容 Claude Desktop。

錯誤：“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 工作流。
• 語義化發佈：使用常規的提交消息。

有關完整的自動化文檔，請參閱 版本發佈自動化指南。

高級文檔

• 版本發佈自動化指南 - 完整的自動化版本發佈和分發系統。
• 訂閱層級支持 - 不同 LicenseSpring 訂閱層級的詳細指南。
• 分發指南 - 完整的設置和共享說明。
• 測試報告 - 全面的測試結果和驗證。
• 遷移指南 - 技術實現細節。

📄 許可證

此 MCP 服務器根據 MIT 許可證授權。這意味著您可以自由使用、修改和分發該軟件，但需遵守 MIT 許可證的條款和條件。有關更多詳細信息，請參閱項目倉庫中的 LICENSE 文件。

商標聲明

本項目經 Cense Data Inc. 許可使用 LicenseSpring® 名稱。詳情請參閱 TRADEMARK 文件。