MCP提交

Netskope MCP

Netskope NPA MCP Server是一个通过大型语言模型管理Netskope网络私有访问基础设施的协议服务器，提供50多种工具进行配置管理。

安全开发者工具 #网络访问 #零信任 #配置管理 #API工具本地 .TypeScript

2.5分

2025-04-29 03:42:29

概述

安装

工具列表

内容详情

替代品

什么是Netskope NPA MCP Server?

Netskope NPA MCP Server是一款通过大型语言模型（LLMs）管理和控制Netskope网络私有访问（NPA）基础设施的工具。它允许您轻松创建、更新和删除与Netskope相关的资源，如本地代理、私人应用程序、升级配置文件等。

如何使用Netskope NPA MCP Server?

首先安装Netskope NPA MCP Server，然后设置环境变量并运行相关命令来执行具体操作。例如，您可以列出所有本地代理、创建新的私人应用程序或更新现有的升级配置文件。

适用场景

适合需要集中管理Netskope NPA环境的企业客户，特别是那些希望自动化其网络私有访问流程的IT团队。

主要功能

本地代理管理列出、创建、更新和删除本地代理实例，支持高可用性和负载均衡。

私人应用程序管理定义和配置私人应用程序，包括协议、端口和安全设置。

升级配置文件管理创建、更新和删除升级配置文件，支持自动化的定期升级。

优势与局限性

优势

简化复杂的Netskope NPA管理任务。

支持大规模自动化运维，提高效率。

提供了丰富的API接口，便于集成到现有系统中。

局限性

仍处于开发阶段，部分功能可能不稳定。

需要管理员具备一定的技术背景才能完全利用该工具。

对硬件资源有一定要求，不适合低性能设备。

如何使用

安装Netskope NPA MCP Server通过npm安装包或克隆代码仓库进行本地开发。

配置环境变量设置NETSKOPE_BASE_URL和NETSKOPE_API_KEY两个必要环境变量。

运行命令根据需求执行相应的MCP命令，例如列出本地代理或创建私人应用程序。

使用案例

列出所有本地代理展示当前环境中所有已注册的本地代理及其状态。

创建新私人应用程序定义一个新的私人应用程序，用于访问内部资源。

更新升级配置文件调整特定升级配置文件的时间和频率。

常见问题

如何检查本地代理的状态？可以使用listLocalBrokers()命令查看所有本地代理的状态。

创建私人应用程序时需要哪些参数？至少需要提供应用程序名称(app_name)、主机地址(host)以及协议类型(protocols)。

如何更新升级配置文件？调用updateUpgradeProfile()函数并传入目标ID和更新后的数据即可完成操作。

Netskope API 文档

用户管理

`listUsers`

描述: 列出所有用户
请求方法: GET
路径: /users
参数:
- fields: 可选的逗号分隔字段列表（如 name, email, role）

响应:

{
  "status": "success",
  "data": {
    "users": [
      {
        "id": "string",
        "name": "string",
        "email": "string",
        "role": "string"
      }
    ],
    "pagination": {
      "page": integer,
      "pageSize": integer,
      "totalPages": integer,
      "totalItems": integer
    }
  }
}

`createUser`

描述: 创建新用户
请求方法: POST
路径: /users

请求体:

{
  "name": "string",
  "email": "string",
  "role": "string"
}

`updateUser`

描述: 更新现有用户
请求方法: PUT
路径: /users/{userId}

请求体:

{
  "name": "string",
  "email": "string",
  "role": "string"
}

`deleteUser`

描述: 删除用户
请求方法: DELETE
路径: /users/{userId}

发布商管理

`listPublishers`

描述: 列出所有发布商
请求方法: GET
路径: /publishers
参数:
- fields: 可选的逗号分隔字段列表（如 name, status, region）

响应:

{
  "status": "success",
  "data": {
    "publishers": [
      {
        "id": "string",
        "name": "string",
        "status": "active" | "inactive",
        "region": "string"
      }
    ],
    "pagination": {
      "page": integer,
      "pageSize": integer,
      "totalPages": integer,
      "totalItems": integer
    }
  }
}

`createPublisher`

描述: 创建新发布商
请求方法: POST
路径: /publishers

请求体:

{
  "name": "string",
  "status": "active" | "inactive",
  "region": "string"
}

`updatePublisher`

描述: 更新现有发布商
请求方法: PUT
路径: /publishers/{publisherId}

请求体:

{
  "name": "string",
  "status": "active" | "inactive",
  "region": "string"
}

`deletePublisher`

描述: 删除发布商
请求方法: DELETE
路径: /publishers/{publisherId}

策略管理

`listPolicies`

描述: 列出所有策略
请求方法: GET
路径: /policies
参数:
- fields: 可选的逗号分隔字段列表（如 name, type, status）

响应:

{
  "status": "success",
  "data": {
    "policies": [
      {
        "id": "string",
        "name": "string",
        "type": "firewall" | "vpn" | "auth",
        "status": "active" | "inactive"
      }
    ],
    "pagination": {
      "page": integer,
      "pageSize": integer,
      "totalPages": integer,
      "totalItems": integer
    }
  }
}

`createPolicy`

描述: 创建新策略
请求方法: POST
路径: /policies

请求体:

{
  "name": "string",
  "type": "firewall" | "vpn" | "auth",
  "status": "active" | "inactive"
}

`updatePolicy`

描述: 更新现有策略
请求方法: PUT
路径: /policies/{policyId}

请求体:

{
  "name": "string",
  "type": "firewall" | "vpn" | "auth",
  "status": "active" | "inactive"
}

`deletePolicy`

描述: 删除策略
请求方法: DELETE
路径: /policies/{policyId}

监控与诊断

`getUsageStats`

描述: 获取使用统计信息
请求方法: GET
路径: /monitoring/usage
参数:
- timeRange: 时间范围（如 "last_hour"、"today"）

响应:

{
  "status": "success",
  "data": {
    "stats": [
      {
        "timestamp": "string",
        "usage": integer,
        "peakUsage": integer
      }
    ]
  }
}

`getLogs`

描述: 获取日志
请求方法: GET
路径: /monitoring/logs
参数:
- level: 日志级别（如 "info"、"warning"、"error"）

响应:

{
  "status": "success",
  "data": {
    "logs": [
      {
        "timestamp": "string",
        "level": "info" | "warning" | "error",
        "message": "string"
      }
    ],
    "pagination": {
      "page": integer,
      "pageSize": integer,
      "totalPages": integer,
      "totalItems": integer
    }
  }
}

升级与维护

`checkUpdates`

描述: 检查可用更新
请求方法: GET
路径: /maintenance/updates

响应:

{
  "status": "success",
  "data": {
    "updates": [
      {
        "version": "string",
        "releaseDate": "string",
        "notes": "string"
      }
    ]
  }
}

`applyUpdate`

描述: 应用更新
请求方法: POST
路径: /maintenance/updates/{updateVersion}

响应:

{
  "status": "success",
  "message": "string"
}

验证工具

`validateName`

描述: 验证名称是否有效
请求方法: POST
路径: /validation/username

请求体:

{
  "name": "string"
}
- **响应**:
  ```json
  {
    "status": "success",
    "isValid": boolean
  }

`validateResource`

描述: 验证资源是否存在
请求方法: GET
路径: /validation/resource/{resourceId}

响应:

{
  "status": "success",
  "exists": boolean
}

搜索工具

`searchUsers`

描述: 搜索用户
请求方法: GET
路径: /search/users
参数:
- query: 搜索关键字（如 name、email）

响应:

{
  "status": "success",
  "results": [
    {
      "id": "string",
      "name": "string",
      "email": "string"
    }
  ],
  "pagination": {
    "page": integer,
    "pageSize": integer,
    "totalPages": integer,
    "totalItems": integer
  }
}

`searchResources`

描述: 搜索资源
请求方法: GET
路径: /search/resources
参数:
- query: 搜索关键字（如 name、type）

响应:

{
  "status": "success",
  "results": [
    {
      "id": "string",
      "name": "string",
      "type": "string"
    }
  ],
  "pagination": {
    "page": integer,
    "pageSize": integer,
    "totalPages": integer,
    "totalItems": integer
  }
}

示例请求与响应

获取策略列表

请求:

GET /policies HTTP/1.1
Content-Type: application/json

响应:

{
  "status": "success",
  "data": {
    "policies": [
      {
        "id": "policy_001",
        "name": "Firewall Policy 1",
        "type": "firewall",
        "status": "active"
      },
      {
        "id": "policy_002",
        "name": "VPN Policy 2",
        "type": "vpn",
        "status": "inactive"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "totalPages": 2,
      "totalItems": 15
    }
  }
}

检查更新

请求:

GET /maintenance/updates HTTP/1.1
Content-Type: application/json

响应:

{
  "status": "success",
  "data": {
    "updates": [
      {
        "version": "2.5.0",
        "releaseDate": "2023-10-01",
        "notes": "New features and bug fixes"
      },
      {
        "version": "2.4.1",
        "releaseDate": "2023-09-15",
        "notes": "Security patches"
      }
    ]
  }
}

验证名称

请求:

POST /validation/username HTTP/1.1
Content-Type: application/json

{
  "name": "admin_user_123"
}

响应:

{
  "status": "success",
  "isValid": true
}

搜索用户

请求:

GET /search/users?query=admin HTTP/1.1
Content-Type: application/json

响应:

{
  "status": "success",
  "results": [
    {
      "id": "user_001",
      "name": "Admin User 1",
      "email": "admin@company.com"
    },
    {
      "id": "user_002",
      "name": "Admin User 2",
      "email": "admin2@company.com"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 10,
    "totalPages": 2,
    "totalItems": 15
  }
}

注意事项

认证与授权: 所有请求需要有效的认证令牌，具体请参考相关文档。
错误处理: 如返回状态码为非2xx，需根据响应体中的error字段处理错误。
速率限制: 高频率调用可能触发速率限制，请合理控制请求次数。
日志与监控: 建议开启详细日志记录以便排查问题和监控系统状态。

如需进一步了解每个接口的具体参数和使用场景，建议查阅完整的API文档或联系技术支持。

AIbase是一个专注于MCP服务的平台，为AI开发者提供高质量的模型上下文协议服务，助力AI应用开发。

简体中文

用户协议

隐私政策

Netskope MCP

什么是Netskope NPA MCP Server?

如何使用Netskope NPA MCP Server?

适用场景

主要功能

优势与局限性

如何使用

使用案例

常见问题

相关资源

Netskope API 文档

用户管理

listUsers

createUser

updateUser

deleteUser

发布商管理

listPublishers

createPublisher

updatePublisher

deletePublisher

策略管理

listPolicies

createPolicy

updatePolicy

deletePolicy

监控与诊断

getUsageStats

getLogs

升级与维护

checkUpdates

applyUpdate

验证工具

validateName

validateResource

搜索工具

searchUsers

searchResources

示例请求与响应

获取策略列表

检查更新

验证名称

搜索用户

注意事项

`listUsers`

`createUser`

`updateUser`

`deleteUser`

`listPublishers`

`createPublisher`

`updatePublisher`

`deletePublisher`

`listPolicies`

`createPolicy`

`updatePolicy`

`deletePolicy`

`getUsageStats`

`getLogs`

`checkUpdates`

`applyUpdate`

`validateName`

`validateResource`

`searchUsers`

`searchResources`