LicenseSpring MCP Server

LicenseSpring®MCP服务器

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

特性

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

工具

许可证API工具

• 激活许可证 -激活带有硬件ID绑定的许可证
• check_license -检查许可证状态和有效性
• 停用许可证 -停用特定硬件的许可证
• add_消费 -将消耗单位添加到许可证中
• 获取试验密钥 -生成试用许可证密钥
• get_product_details -检索产品信息
• 浮动租赁 -发布浮动许可证
• 浮动借款 -借用浮动许可证供离线使用
• 更改密码 -更改基于用户的许可证的用户密码
• 获取版本 -获取可用的软件版本
• get_installation_file -获取安装文件信息
• get_so_url -生成单点登录URL

管理API工具

• list_licences -列出具有可选筛选功能的许可证
• 创建许可证 -创建新许可证
• update_license -更新现有许可证
• get_license -获取详细的许可证信息
• 删除许可 -删除许可证
• 列表_客户 -列出具有筛选选项的客户
• 创建_客户 -创造新客户

配置

正在获取API凭据

1. 许可证API密钥：登录您的LicenseSpring仪表板→ 设置→ 密钥（主身份验证方法）
2. 管理API密钥：相同位置，复制管理API密钥
3. 共享密钥：对于使用共享API设置的组织是可选的（提供增强的安全性）

测试

运行综合集成测试以验证功能：

# Build the project
npm run build

# Run integration tests against real LicenseSpring API
npm run test:integration

# Run unit tests
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"
      }
    }
  }
}

码头工人

{
  "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代码

为了快速安装，请使用下面的一键安装按钮：



对于手动安装，请将以下JSON块添加到VS Code中的用户设置（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无法确定要运行的可执行文件”

• 解决方案：更新到1.0.1或更高版本： npx @tfedorko/licensespring-mcp-server@latest
• 原因：在v1.0.1中修复了-改进了二进制配置和启动过程

错误：“MCP错误-1：连接已关闭”

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

错误：“需要LICENSE_API_KEY”

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

错误：“身份验证失败”

• 解决方案：在LicenseSpring面板中验证您的API密钥
• 备注: LICENSE_SHARED_KEY 对于基本/标准订阅层是可选的

服务器启动但API调用失败

• 检查：您的LicenseSpring订阅层和可用的API功能
• 解决方案：服务器为订阅限制提供了有用的指导

获取帮助

1. 检查错误消息-它们提供了具体的指导
2. 验证您的LicenseSpring订阅层和API访问权限
3. 查看 高级文档 在......下面
4. 在GitHub上打开一个包含错误详细信息的问题

发布自动化

该项目包括全面的自动化版本控制和NPM分发：

快速释放命令

npm run release          # Patch release (1.0.0 -> 1.0.1)
npm run release:minor    # Minor release (1.0.0 -> 1.1.0)
npm run release:major    # Major release (1.0.0 -> 2.0.0)

预览更改

npm run version:dry      # Preview version bump
npm run publish:dry      # Preview NPM publish

自动GitHub发布

• 提交触发器：使用 [release] 在提交消息中
• 人工调度：GitHub操作工作流
• 语义释放：常规提交消息

有关完整的自动化文档，请参阅 发布自动化指南.

高级文档

有关全面指南和高级配置：

• 发布自动化指南 -完整的自动化发布和分发系统
• 订阅层支持 -不同LicenseSpring订阅层的详细指南
• 分销指南 -完成设置和共享说明
• 测试报告 -全面的测试结果和验证
• 迁移指南 -技术实施细节

安装

NPM包

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

备注：需要Node.js 20.x或更高版本以获得最佳兼容性。

Docker镜像

# License API Server
docker pull stiertfedorko/licensespring-mcp:latest

# Management API Server
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股份有限公司的许可下使用LicenseSpring®名称。请参阅 商标 文件以获取详细信息。