JFrog MCP Server (🧪 Experimental)

1. check_jfrog_availability

   • 检查 JFrog 平台是否已就绪并正常运行
   • 返回：平台就绪状态

2. create_local_repository

   • 在 Artifactory 中创建新的本地仓库
   • 输入：
     • key（字符串）：仓库键
     • rclass（字符串）：仓库类别（必须为 "local"）
     • packageType（字符串）：仓库的软件包类型
     • description（可选字符串）：仓库描述
     • projectKey（可选字符串）：要将仓库分配到的项目键
     • environments（可选字符串数组）：要分配给仓库的环境
   • 返回：已创建的仓库详情

3. create_remote_repository

   • 在 Artifactory 中创建新的远程仓库，用于代理外部软件包注册表
   • 输入：
     • key (string)：仓库键
     • rclass (string)：仓库类别（必须为 "remote"）
     • packageType (string)：仓库的软件包类型
     • url (string)：远程仓库的 URL
     • username (optional string)：远程仓库用户名
     • password (optional string)：远程仓库密码
     • description (optional string)：仓库描述
     • projectKey (optional string)：要将仓库分配到的项目键
     • environments (optional string[])：要将仓库分配到的环境
     • 其他许多用于特定仓库配置的可选参数
   • 返回：已创建的仓库详情

4. create_virtual_repository

   • 在 Artifactory 中创建新的虚拟仓库，以聚合多个仓库
   • 输入：
     • key (string)：仓库键
     • rclass (string)：仓库类别（必须为 "virtual"）
     • packageType (string)：仓库的软件包类型
     • repositories (string[])：要纳入虚拟仓库的仓库键列表
     • description (optional string)：仓库描述
     • projectKey (optional string)：要将仓库分配到的项目键
     • environments (optional string[])：要将仓库分配到的环境
     • 其他用于特定仓库配置的可选参数
   • 返回：已创建的仓库详情

5. list_repositories

   • 列出 Artifactory 中的所有仓库，并支持可选筛选
   • 输入：
     • type (optional string)：按类型筛选仓库（local、remote、virtual、federated、distribution）
     • packageType (optional string)：按软件包类型筛选仓库
     • project (optional string)：按项目键筛选仓库
   • 返回：符合筛选条件的仓库列表

6. set_folder_property

   • 为 Artifactory 中的文件夹设置属性，并可选择递归应用
   • 输入：
     • folderPath (string)：要设置属性的文件夹路径
     • properties (object)：要设置的键值对
     • recursive (optional boolean)：是否递归为子文件夹应用属性
   • 返回：操作结果

7. execute_aql_query

   • 执行 Artifactory Query Language (AQL) 查询，以搜索 JFrog Artifactory 中的制品、构建或其他实体
   • 输入：
     • query (string)：要执行的 AQL 查询。必须遵循 AQL 语法（例如：items.find({"repo":"my-repo"}).include("name","path")）
     • domain (optional string)：要搜索的主要领域（items、builds、archive.entries、build.promotions、releases）
     • transitive (optional boolean)：是否搜索远程仓库
     • limit (optional number)：要返回的最大结果数
     • offset (optional number)：要跳过的结果数
     • include_fields (optional string[])：结果中要包含的字段
     • sort_by (optional string)：结果排序所依据的字段
     • sort_order (optional string)：排序顺序（asc 或 desc）
   • 返回：包含元数据的搜索结果

8. list_jfrog_builds

   • 返回 JFrog 平台中的所有构建列表
   • 返回：构建列表

9. get_specific_build

   • 按名称获取特定构建的详情
   • 输入：
     • buildName (string)：要获取的构建名称
     • project (optional string)：用于限定构建搜索范围的项目键
   • 返回：构建详情

11. get_jfrog_runtime_specific_cluster

    • 根据 ID 返回运行时集群
    • 输入：
      • clusterId（整数）：要获取的集群 ID
    • 返回：集群详情

12. list_jfrog_running_images

    • 列出各运行时集群中所有正在运行的容器镜像及其安全和运行状态
    • 输入：
      • filters（可选字符串）：要应用的筛选条件
      • num_of_rows（可选整数）：要返回的行数
      • page_num（可选整数）：页码
      • statistics（可选布尔值）：是否包含统计信息
      • timePeriod（可选字符串）：要查询的时间段
    • 返回：正在运行的镜像列表

13. list_jfrog_environments

    • 获取 JFrog 平台中所有环境类型及其详情的列表
    • 输入：
    • 返回：环境列表

14. list_jfrog_projects

    • 获取 JFrog 平台中所有项目及其详情的列表
    • 输入：
    • 返回：项目列表

15. get_specific_project

    • 获取 JFrog 平台中特定项目的详细信息
    • 输入：
      • project_key（字符串）：要获取的项目的唯一键
    • 返回：项目详情

16. create_project

    • 在 JFrog 平台中创建新项目
    • 输入：
      • project_key（字符串）：项目的唯一标识符
      • display_name（字符串）：项目的显示名称
      • description（字符串）：项目描述
      • admin_privileges（对象）：项目的管理权限
      • storage_quota_bytes（数字）：存储配额，单位为字节（-1 表示不受限制）
    • 返回：已创建的项目详情

17. jfrog_get_package_info

    • 获取软件包的公开信息
    • 输入：
      • type（字符串）：软件包类型（pypi、npm、maven、golang、nuget、huggingface、rubygems）
      • name（字符串）：软件包在软件包仓库中显示的名称
      • version（可选字符串）：软件包版本（默认值："latest"）
    • 返回：软件包信息，包括描述、最新版本、许可证和 URL

18. jfrog_get_package_versions

    • 获取公开软件包的版本列表及其发布日期
    • 输入：
      • type（字符串）：软件包类型（pypi、npm、maven、golang、nuget、huggingface、rubygems）
      • name（字符串）：软件包在软件包仓库中显示的名称
    • 返回：软件包版本列表及其发布日期

19. jfrog_get_package_version_vulnerabilities

    • 获取影响某个开源软件包特定版本的已知漏洞列表
    • 输入：
      • type（字符串）：软件包类型（pypi、npm、maven、golang、nuget、huggingface、rubygems）
      • name（字符串）：软件包在软件包仓库中显示的名称
      • version（可选字符串）：软件包版本（默认值："latest"）
      • pageSize（可选数字）：每页返回的漏洞数量（默认值：10）
      • pageCount（可选数字）：要返回的页数（默认值：1）
    • 返回：影响指定软件包版本的漏洞列表

20. jfrog_get_vulnerability_info

    • 获取特定漏洞的详细信息，包括受影响的软件包和版本
    • 输入：
      • cve_id（字符串）：要查询的 CVE ID 或漏洞标识符
      • pageSize（可选数字）：每页返回的漏洞数量（默认值：10）
      • pageCount（可选数字）：返回的页数（默认值：1）
    • 返回：漏洞详细信息和受影响的软件包

21. jfrog_get_package_curation_status

    • 检查特定软件包版本的筛选状态
    • 输入：
      • packageType（字符串）：软件包类型（pypi、npm、maven、golang、nuget、huggingface、rubygems）
      • packageName（字符串）：软件包在软件包仓库中显示的名称
      • packageVersion（字符串）：软件包在软件包仓库中显示的版本
    • 返回：筛选状态（approved、blocked 或 inconclusive）

22. jfrog_get_artifacts_summary
    • 获取仓库或构建中制品问题的摘要，按严重级别（Low、Medium、High、Critical、Unkown）分类并计数
    • 输入：
      • paths（字符串数组）：用于生成摘要的制品路径数组
    • 返回：根据所提供数组中每个制品的各严重级别漏洞数量生成的摘要，以及问题总数

npm

{
  "mcpServers": {
    "MCP-JFrog": { 
      "command": "npm",
      "args": [
        "exec",
        "-y",
        "github:jfrog/mcp-jfrog"
      ],
      "env": {
        "JFROG_ACCESS_TOKEN": "ACCESS_TOKEN",
        "JFROG_URL": "https://<YOUR_JFROG_INSTANCE_URL>"
      }
    }
  },
  "mcp-local-dev":{
      "command": "node",
      "args": [
        "/<ABSOLUT_PATH_TO>/mcp-jfrog/dist/index.js"
      ],
      "env": {
        "JFROG_ACCESS_TOKEN": "<ACCESS_TOKEN>>",
        "JFROG_URL": "<JFROG_URL>"
      }
    }
}

Docker

{
  "mcpServers": { 
    "jfrog": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "JFROG_ACCESS_TOKEN",
        "-e",
        "JFROG_URL",
        "mcp/jfrog"
      ],
      "env": {
        "JFROG_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "JFROG_URL": "https://your-instance.jfrog.io"
      },
      "serverUrl": "http://localhost:8080/sse"
    }
  }
}

SSE 传输模式

要让 JFrog MCP Server 使用 SSE 传输模式（适用于 Cursor WebView 等 Web 界面）：

{
  "mcpServers": { 
    "jfrog-sse": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-p",
        "8080:8080",
        "-e",
        "TRANSPORT=sse",
        "-e",
        "PORT=8080",
        "-e",
        "CORS_ORIGIN=*",
        "-e",
        "LOG_LEVEL=INFO",
        "-e",
        "MAX_RECONNECT_ATTEMPTS=5",
        "-e",
        "RECONNECT_DELAY_MS=2000",
        "-e",
        "JFROG_ACCESS_TOKEN",
        "-e",
        "JFROG_URL",
        "mcp/jfrog"
      ],
      "env": {
        "JFROG_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "JFROG_URL": "https://your-instance.jfrog.io",
        "serverUrl": "http://localhost:8080/sse"
      }
    }
  }
}

注意：使用 SSE 模式时，需要添加指向 SSE 端点的 serverUrl 参数，并公开服务使用的端口（-p 8080:8080）。

将以下内容添加到 claude_desktop_config.json：

Docker

{
  "mcpServers": { 
    "jfrog": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "JFROG_ACCESS_TOKEN",
        "-e",
        "JFROG_URL",
        "mcp/jfrog"
      ],
      "env": {
        "JFROG_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "JFROG_URL": "https://your-instance.jfrog.io" // Your JFrog platform URL
      },
      "serverUrl": "http://localhost:8080/sse"
    }
  }
}

npm

{
"mcpServers": {
    "MCP-JFrog": { 
      "command": "npm",
      "args": [
        "exec",
        "-y",
        "github:jfrog/mcp-jfrog"
      ],
      "env": {
        "JFROG_ACCESS_TOKEN": "ACCESS_TOKEN",
        "JFROG_URL": "https://<YOUR_JFROG_INSTANCE_URL>"
      }
    }
  }
}

SSE 传输模式

让 Claude Desktop 使用 SSE 传输：

{
  "mcpServers": { 
    "jfrog-sse": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-p",
        "8080:8080",
        "-e",
        "TRANSPORT=sse",
        "-e",
        "PORT=8080",
        "-e",
        "CORS_ORIGIN=*",
        "-e",
        "LOG_LEVEL=INFO",
        "-e",
        "MAX_RECONNECT_ATTEMPTS=5",
        "-e",
        "RECONNECT_DELAY_MS=2000",
        "-e",
        "JFROG_ACCESS_TOKEN",
        "-e",
        "JFROG_URL",
        "mcp/jfrog"
      ],
      "env": {
        "JFROG_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "JFROG_URL": "https://your-instance.jfrog.io",
        "serverUrl": "http://localhost:8080/sse"
      }
    }
  }
}

</details>


## License

This MCP server is licensed under the Apache License 2.0. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the Apache License 2.0. For more details, please see the LICENSE.md file in the project repository.