AI导哈

ISP管理协议服务器

一个只读的MCP服务器，用于查询和管理ISP客户、发票、收款、互联网连接、支持票据、网络状态和FTTx基础设施等。

  • by dmayan-ss
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 dmayan-ss/mcp-ispkeeper

使用说明

mcp管理员

用于的只读MCP（模型上下文协议）服务器 ISPKeeper --ISP管理软件。

通过任何兼容MCP的客户端（Claude Desktop、Claude Code等）查询客户端、发票、收款、互联网连接、支持票、网络状态、FTTx基础设施等。

特性

  • 客户 --使用可扩展的关系、更改日志和付款承诺搜索、过滤和检索客户详细信息
  • 发票 --列出并检查带有项目、合并数据和PDF打印链接的发票
  • 集合 --使用用户和日期过滤器浏览付款收款
  • 互联网连接 --按技术、计划、状态查询连接；查看更改日志
  • 电视和电话 --列出并检查电视和电话服务连接
  • 支持工单 --列出门票、查看详细信息、照片、移动日志、签到/结账、聊天附件和浏览类别/子类别/状态
  • 网络 --检查网络状态、中断、节点、子节点、VLAN、SVLAN和计划
  • FTTx基础设施 --浏览光纤层次结构：主干、PON、NAP盒、端口、密封件和向上跟踪元素
  • 辅助数据 --地点、分支机构、用户、仓库、支付方式、客户类别、票证元数据和参考数据

可用工具（27）

客户

工具 说明
search_clients 使用文本、日期、税务状态和截止过滤器搜索客户
get_client 获取客户详细信息、更改日志或付款承诺检查
get_clients_summary 快速汇总总客户数和活跃客户数
get_client_services 获取客户发票、收款、票据或其他附加信息
list_clients_log 使用日期过滤器列出所有客户端的更改历史日志

发票和收款

工具 说明
list_invoices 列出按日期、类型和销售点筛选的发票
get_invoice 获取发票详细信息、项目、合并数据或PDF打印链接
list_collections 列出按日期和用户筛选的付款收款
get_collection 获取收集详细信息或合并数据

服务连接

工具 说明
list_internet_connections 列出按技术、计划、状态、客户筛选的连接
get_internet_connection 获取互联网连接详细信息或更改日志
list_internet_connections_log 列出所有互联网连接的更改日志
list_tv_connections 列出所有电视服务连接
get_tv_connection 获取特定电视连接的详细信息
list_phone_connections 列出所有电话/电话连接
get_phone_connection 获取特定电话连接的详细信息

支持工单

工具 说明
list_tickets 列出按日期、类别、状态筛选的票
get_ticket 获取门票详情、照片、动态日志、签到/结账或聊天附件
list_tickets_log 列出所有票证的票证活动日志

网络和计划

工具 说明
get_network_status 使用可选的停机日期筛选器获取网络状态
list_plans 列出已删除/已停用过滤器的互联网计划

FTTx基础设施

工具 说明
list_fttx_infrastructure 通过深入查询FTTx资源（骨干网、PON、盒子、端口、封条）
get_fttx_trace 向上跟踪FTTx元素：端口→ box → PON → 骨干

辅助和参考数据

工具 说明
list_auxiliary_data 列出地区、分支机构、用户、仓库、付款方式、票证类别/子类别/状态等
get_network_element 获取节点、子节点、VLAN、SVLAN、用户、分支机构、仓库、附加、支付方式或票证类别/子类别/状态的详细信息

安装

克劳德桌面/克劳德代码（MCP配置）

添加到MCP设置中，调整平台的路径：

视窗

{
  "mcpServers": {
    "ispkeeper": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-ispkeeper\\dist\\index.js"],
      "env": {
        "ISPKEEPER_API_KEY": "your-api-key",
        "ISPKEEPER_BASE_URL": "https://api.anatod.ar"
      }
    }
  }
}

Linux/WSL

{
  "mcpServers": {
    "ispkeeper": {
      "command": "node",
      "args": ["/path/to/mcp-ispkeeper/dist/index.js"],
      "env": {
        "ISPKEEPER_API_KEY": "your-api-key",
        "ISPKEEPER_BASE_URL": "https://api.anatod.ar"
      }
    }
  }
}

来源

git clone https://github.com/dmayan-ss/mcp-ispkeeper.git
cd mcp-ispkeeper
npm install
npm run build

平台兼容性

工作在 视窗, Linux，以及 Windows 子系统 for Linux 没有变化。要求：

  • Node.js>=18（使用原生 fetch)
  • 无原生/编译依赖关系——纯JavaScript
  • Stdio运输适用于所有平台
  • shebang(#!/usr/bin/env node)允许在类Unix系统上直接执行，在Windows上被忽略

配置

环境变量 必填 默认 描述
ISPKEEPER_API_KEY 是 - ISPKeeper API密钥(x-api-key 头球
ISPKEEPER_BASE_URL 没有 https://api.anatod.ar ISPKeeper实例的基本URL

发展

npm run dev      # Run with tsx (hot reload)
npm run build    # Build with esbuild
npm run bundle   # Build + create .mcpb package

许可证

麻省理工学院

相关 MCP