Netskope NPA MCP服务器
一个全面的模型上下文协议（MCP）服务器，用于通过人工智能驱动的自动化管理Netskope专用访问（NPA）基础设施。
📚 完整的文件
该项目包括为便于导航而组织的大量文档：
👉 从完整文档开始 -概述和导航指南
快速访问链接
工具概览
MCP服务器提供 84专用工具 跨越10个类别：
| 类别 | 工具 | 主要用例 |
|---|---|---|
| 出版商 | 9个工具 | 基础设施部署和管理 |
| 私人应用程序 | 15个工具 | 应用程序生命周期和配置 |
| 本地经纪人 | 7个工具 | 网络连接和路由 |
| 策略管理 | 6工具 | 访问控制和安全规则 |
| SCIM集成 | 5个工具 | 身份和用户管理 |
| 升级配置文件 | 7种工具 | 自动化维护计划 |
| 转向 | 3个工具 | 交通路线和关联 |
| 警报 | 2个工具 | 事件监控和通知 |
| 搜索 | 2个工具 | 资源发现和查询 |
| 验证 | 2个工具 | 配置合规性 |
实际使用示例
🏢 “为我们的新伦敦办事处建立完整的NPA基础设施”
AI响应：执行全面的部署工作流程
- ✅ 创建具有自动升级配置文件的发布者
- ✅ 为内部路由配置本地代理
- ✅ 设置核心业务应用程序（CRM、ERP、文件服务器）
- ✅ 使用SCIM组验证创建访问策略
- ✅ 支持对办公网络的监控和发现
- ✅ 为现场部署生成注册令牌
🚨 “紧急：安全事件-立即锁定人力资源/财务应用程序”
AI响应：应急安保响应工作流程
- ✅ 自动识别所有人力资源/财务应用程序
- ✅ 创建具有最高优先级的应急策略组
- ✅ 阻止除事件响应团队之外的所有用户访问
- ✅ 增强对安全事件的监控
- ✅ 事件跟踪标签应用程序
📊 “对我们的NPA环境进行全面的合规审计”
AI响应：自动合规性评估
- ✅ 审核所有发布者的版本合规性
- ✅ 识别没有访问策略的应用程序
- ✅ 验证策略中的SCIM组引用
- ✅ 生成合规性评分和补救计划
- ✅ 创建具有优先级的详细调查结果报告
快速开始
- 环境设置
export NETSKOPE_BASE_URL="https://your-tenant.goskope.com"
export NETSKOPE_TOKEN="your-api-token"- 安装并运行
npm install
npm run build
npm start- 通过MCP客户端连接
{
"mcpServers": {
"netskope-npa": {
"command": "node",
"args": ["/path/to/privateaccess-mcp/build/index.js"],
"env": {
"NETSKOPE_BASE_URL": "https://your-tenant.goskope.com",
"NETSKOPE_TOKEN": "your-api-token"
}
}
}
}主要特点
🤖 AI原生设计
- 为LLM交互设计的工具，具有清晰的描述
- 自动参数验证和转换
- 用于故障排除的丰富错误上下文
🔄 工作流程编排
- 工具自动相互协调
- 内置重试逻辑和错误恢复
- 尽可能进行交易操作
🛡️ 生产就绪
- 使用Zod模式进行全面的输入验证
- 费率限制和API配额管理
- 详细的日志记录和监控
🔗 集成模式
- SCIM集成用于身份解析
- 资源发现的搜索工具
- 用于合规性检查的验证工具
安装选项
NPM包
npm install @johnneerdael/ns-private-access-mcp本地开发
git clone https://github.com/johnneerdael/privateaccess-mcp.git
cd privateaccess-mcp
npm install
npm run build通用JSON客户端配置
对于采用JSON映射的客户端（Cursor、Windsurf、自定义主机）：
{
"mcpServers": {
"netskope": {
"url": "https://{hosted-endpoint}/mcp",
"headers": {
"X-Netskope-Tenant": "https://YOUR-TENANT.goskope.com",
"Authorization": "Bearer YOUR_NETSKOPE_API_TOKEN"
}
}
}
}自足执行
更喜欢运行自己的实例？附带两个合成文件：
| 文件 | 目的 | 命令 |
|---|---|---|
docker-compose.yml | 从GHCR运行预构建的多拱形图像。 | docker compose up -d |
docker-compose.build.yml | 从当地资源中构建（用于发展）。 | docker compose -f docker-compose.build.yml up --build |
没有作曲的一句话：
# Prebuilt image from GHCR
docker run --rm -p 3000:3000 ghcr.io/johnneerdael/privateaccess-mcp:latest
# Build and run from a local checkout
docker build -t netskope-mcp:local .
docker run --rm -p 3000:3000 netskope-mcp:local
# Or just run the Node entry directly
npm run build && PORT=3000 node dist/cli-http.js容器暴露 /mcp （可流式传输HTTP）和 /healthz （活力）。 有用的环境变量：
| Var | 目的 |
|---|---|
PORT / HOST | 绑定地址（默认 0.0.0.0:3000). |
PUBLIC_URL | 标准公共来源（例如。 https://privateaccess.ntsk.app).表面处理 /healthz 以及启动日志；保留用于未来的OAuth/众所周知的元数据。可以放心省略。 |
CORS_ORIGIN | 逗号分隔的列表 *浏览器*-基于MCP客户端（例如。 https://claude.ai).默认为 *。与CLI客户端（Claude Code、Codex、Cursor）或在本身不需要CORS的反向代理后面运行时无关。 |
NETSKOPE_BASE_URL / NETSKOPE_API_TOKEN | 可选 后备方案 凭据，仅在客户端省略标头时使用。为单租户部署设置这两个选项；对于多租户托管（使用的模型 privateaccess.ntsk.app). |
建筑亮点
工具组成
工具旨在通过定义良好的接口协同工作：
// Example: Creating a private app with validation and tagging
1. validateName() -> Check app name compliance
2. searchPublishers() -> Find target publisher
3. createPrivateApp() -> Create the application
4. createPrivateAppTags() -> Add organizational tags
5. updatePublisherAssociation() -> Associate with publishers模式驱动验证
每个工具都使用Zod模式进行类型安全和验证：
const createAppSchema = z.object({
app_name: z.string().min(1).max(64),
host: z.string().url(),
protocols: z.array(protocolSchema),
clientless_access: z.boolean()
});差错恢复
用于处理常见问题的内置模式：
- 从MCP对象中自动提取参数
- 使用指数回退重试逻辑
- 部分故障时性能良好
学分
- 约翰 尼尔达尔 （Netskope专用访问产品经理）
- 米切尔泵 （荷兰首席Netskope解决方案工程师）
获取帮助
- 文件问题：在GitHub上打开一个问题
- 功能请求：创建功能请求问题
- 错误报告：使用错误报告模板
- 安全问题：参见 安全.md
______________________________________________________________________
*此MCP服务器将复杂的Netskope NPA管理转换为简单的AI驱动对话。*