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
许可证
麻省理工学院