星战科技xingzhan.cloud
返回市场
许可弹簧-MCP

许可弹簧-MCP

作者：stier1ba2 星标更新：2025-08-29
安装使用来源：spider==github.com

项目介绍

LicenseSpring® MCP Server

与LicenseSpring API集成的MCP服务器实现，提供全面的许可证管理和客户操作功能。

功能

  • 许可证操作：激活、检查、停用与硬件绑定的许可证
  • 客户管理：创建、列出并管理客户
  • 使用跟踪：监控许可证消耗和功能使用情况
  • 试用管理：生成和管理试用许可证
  • 浮动许可证：处理浮动许可证操作
  • 认证优先级：以LICENSE_API_KEY为主要方法，LICENSE_SHARED_KEY可选用于增强安全性
  • 全面测试：带有真实API验证的完整集成测试套件

工具

许可证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集合完全一致的功能。

🔧 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中使用NPX安装

在VS Code Insiders中使用NPX安装

手动安装，请在VS Code的用户设置（JSON）文件中添加以下JSON块：

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "license_api_key",
        "description": "LicenseSpring 许可证API密钥",
        "password": true
      },
      {
        "type": "promptString",
        "id": "license_shared_key",
        "description": "LicenseSpring 共享密钥（基础/标准版可选）",
        "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: 连接关闭"

  • 解决方案：更新到1.0.2或更高版本：npx @tfedorko/licensespring-mcp-server@latest
  • 原因：已在v1.0.2中修复 - 服务器现在默认为license-api模式，以兼容Claude Desktop

错误："LICENSE_API_KEY是必需的"

  • 解决方案：在.env文件或Claude Desktop配置中设置环境变量
  • 检查：复制.env.example到.env并填写您的API凭证

错误："认证失败"

  • 解决方案：在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工作流
  • 语义化发布：常规提交消息

完整的自动化文档，请参阅**发布自动化指南**。

高级文档

全面指南和高级配置：

安装

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

构建

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文件。