1. 项目概述当AI助手遇上企业级IPAM/DNS如果你是一名网络工程师、系统管理员或者负责管理企业IT基础设施的运维人员那么“IP地址管理”和“DNS记录维护”这两件事大概率是你日常工作中既基础又繁琐的痛点。手动在Excel表格里记录IP分配、在Web界面上一个个点击添加A记录、为了一台新服务器的地址反复核对子网剩余空间……这些重复性劳动不仅耗时还极易出错。而EfficientIP的SolidServer作为一款成熟的企业级IPAMIP地址管理和DNS/DHCP解决方案虽然提供了强大的集中管理能力和API但直接与API交互编写脚本对很多只想快速完成任务的工程师来说门槛依然不低。最近随着AI编程助手如Claude、Cursor的普及一个名为Model Context Protocol的协议逐渐进入开发者视野。简单来说MCP就像给AI助手装上了一套“可插拔的工具箱”。AI本身并不知道如何操作你的SolidServer但通过一个实现了MCP协议的“服务器”ServerAI就能获得操作这些工具的能力并代表你安全、准确地执行任务。tphakala/solidserver-mcp正是这样一个桥梁一个用Go语言编写的MCP服务器专门用于连接你的AI助手和EfficientIP SolidServer。想象一下这个场景你正在和Claude讨论一个部署计划只需要用自然语言说一句“帮我在‘生产网络’空间下的‘10.10.20.0/24’子网里找一个空闲的IP分配给新应用服务器‘app-server-99’并为其创建对应的A记录和PTR记录。” AI助手就能理解你的意图通过这个MCP服务器调用SolidServer的API自动完成查找空闲IP、分配地址、创建正反向DNS记录这一系列操作并将结果清晰地反馈给你。这不仅仅是自动化更是将你的操作意图与底层复杂的API调用无缝衔接了起来。这个项目适合所有使用SolidServer管理网络资源的团队尤其是那些已经习惯使用Claude Desktop、Cursor等AI辅助工具进行日常开发和运维工作的工程师。它不要求你精通Go语言或MCP协议的细节只需要简单的配置就能为你的AI工作流注入强大的网络基础设施管理能力。2. 核心架构与设计思路拆解2.1 为什么是MCP协议层的价值解析在深入这个项目之前我们首先要理解MCPModel Context Protocol解决了什么问题。在没有MCP之前如果你想让AI操作某个系统比如SolidServer通常有几种路径一是使用专门的、封闭的插件系统这受限于AI平台的支持二是让AI生成操作脚本如Python、PowerShell然后由你手动或半自动地去执行这存在安全风险和操作断层。MCP提出了一种标准化的中间层协议。它的核心思想是**“工具定义与调用分离”**。MCP服务器如本项目负责两件事1.宣告能力告诉AI客户端“我有哪些工具可用”比如solidserver_ip_create、solidserver_dns_record_create。2.执行调用当AI客户端需要时接收结构化的调用请求将其转换为对后端系统SolidServer REST API的实际操作并将结果返回。这种设计带来了几个关键优势安全性AI客户端如Claude不直接持有你的SolidServer认证令牌Token令牌仅存在于你本地配置的MCP服务器环境中。AI只是发起请求的“指挥官”真正的“士兵”MCP服务器在受控的环境下执行。标准化一旦AI客户端集成了MCP它就能与任何遵循该协议的服务器通信无需为每个新工具做适配。这极大地扩展了AI的能力边界。灵活性MCP服务器可以以stdio标准输入输出模式运行在本地也可以以http模式部署在远程适应个人使用或团队共享等不同场景。solidserver-mcp项目正是基于此协议将SolidServer复杂的API封装成一组AI易于理解和调用的、功能清晰的工具。2.2 项目结构与技术选型考量该项目采用Go语言编写这是一个非常务实且高效的选择。对于MCP服务器这类需要长期运行、注重稳定性和性能的守护进程Go语言的优势明显单二进制部署编译后生成一个独立的可执行文件无需复杂的运行时环境如Python的虚拟环境、Node.js的node_modules降低了部署和分发成本。用户只需要下载对应平台的二进制文件配置环境变量即可运行。出色的并发性能Go的Goroutine和Channel机制非常擅长处理大量并发的连接和请求。虽然单个MCP服务器的负载通常不会太高但良好的并发基础保证了响应速度和资源利用率。强大的标准库与生态Go的标准库对HTTP客户端、JSON编解码、环境变量读取等支持得非常好。项目依赖清晰主要就是用于实现MCP协议的mcp-go-sdk和用于HTTP通信的net/http库这使得项目结构干净维护性高。从项目根目录的taskfile.yml可以看到开发者使用了Task作为构建工具。相比于直接写MakefileTask的配置文件YAML更易读且能方便地定义跨平台任务。task check一键完成代码格式化、静态检查、 lint 和测试task go:build进行编译这种设计体现了良好的开发者体验DX思维让贡献者能快速上手。注意项目要求Go 1.26这是因为可能用到了较新版本标准库的特性。在准备构建环境时务必确认你的Go版本符合要求否则可能会遇到编译错误。3. 功能全景与核心工具详解solidserver-mcp目前提供了覆盖IPAM、DNS、VLAN和DHCP四大核心模块的工具集基本涵盖了SolidServer日常运维的主要操作。我们来逐一拆解这些工具的设计意图和使用场景。3.1 IPAM工具精准的地址生命周期管理IP地址管理是网络运维的基石。该模块的工具设计紧密贴合实际运维流程。solidserver_ip_createsolidserver_ip_delete这是IP地址的“生”与“死”。create工具的核心逻辑是处理“指定分配”与“自动分配”的平衡。你可以直接请求一个特定的IP如10.0.0.100工具会校验该IP是否在目标子网内且未被占用。更常见的场景是使用“next free”模式工具会查询子网返回并占用下一个可用的IP地址。这里有一个关键细节在大型、碎片化的子网中“下一个可用”的查找逻辑依赖于SolidServer API的ip_find_free功能其效率远高于客户端自己遍历。delete工具则相对简单但要注意其关联性如果该IP地址关联了DNS记录或DHCP静态预留直接删除IP可能会失败或产生遗留数据需要先清理依赖。工具内部应该处理了API返回的相关错误但作为使用者在规划操作流程时应有此意识。solidserver_ip_find_free这是一个强大的“侦察兵”工具。你不仅可以查询一个子网内所有空闲的IP还可以通过参数指定需要的地址数量count和是否排除网络地址、广播地址、网关地址等avoid。例如当你需要为一个新的Kubernetes节点池批量预留20个连续IP时这个工具就能派上用场。它的返回结果是一个列表AI可以据此进行后续的创建操作。solidserver_ip_listsolidserver_subnet_list/info这些是“查看”类工具是几乎所有操作的前置步骤。ip_list支持按IP、MAC地址、设备标识符等进行过滤在排查地址冲突或定位特定设备时极其有用。subnet_info能获取子网的详细信息如掩码、网关、使用率、描述等为AI提供决策上下文例如AI在建议分配IP时可以先查看子网使用率避免推荐一个即将满的子网。solidserver_space_listsolidserver_subnet_create/delete空间Space是SolidServer中顶层的组织单元通常对应一个物理站点、一个业务部门或一个环境如生产/测试。space_list是导航的起点。subnet_create/delete则用于网络规划需要管理员权限。创建子网时需要指定空间、网络地址、掩码、网关等关键参数MCP工具将这些参数结构化避免了在Web界面表单中手动输入的繁琐。3.2 DNS工具记录管理的自动化利器DNS记录的维护同样琐碎且要求高准确性。该模块将常见的记录操作封装成了原子工具。solidserver_dns_record_create/delete支持主流的记录类型AIPv4、AAAAIPv6、CNAME别名、MX邮件交换、TXT文本等。创建记录时除了必填的域名、类型、值TTL通常可缺省使用视图默认值一个最佳实践是同时创建对应的PTR反向解析记录尤其是对于服务器IP。虽然工具可能没有直接提供“同时创建PTR”的复合工具但AI可以通过组合调用record_create为IP创建PTR记录来实现。删除操作通常需要指定记录的唯一标识符如记录ID这可以通过先调用record_list查询获得。solidserver_dns_record_listsolidserver_dns_zone_listrecord_list支持按域名、类型、值进行过滤是理清DNS现状和排查问题的基础。zone_list则列出了所有授权的DNS域AI在操作记录前可以先确认目标域名属于哪个已存在的Zone避免操作失败。3.3 VLAN与DHCP工具网络策略的延伸管理对于集成了二层交换和IP地址分配的环境这些工具提供了更全面的控制。VLAN工具vlan_domain_list,vlan_list/create/delete允许你管理VLAN ID、名称和描述。在自动化网络部署中创建新业务网段时往往需要同时创建VLAN和对应的三层子网这些工具使得AI可以协调完成整个流程。DHCP工具更为细致从服务器dhcp_server_list、作用域dhcp_scope_list、地址池dhcp_range_list到动态租约dhcp_lease_list提供了完整的可见性。最实用的莫过于dhcp_static_add/delete用于管理静态地址保留即固定分配。当为一台服务器分配了静态IP后通过此工具将其MAC地址与IP绑定可以确保DHCP服务器始终为其分配同一地址结合IPAM中的地址占用状态实现了IP资源的全生命周期闭环管理。4. 配置与部署实战指南让solidserver-mcp跑起来并接入你的AI客户端是整个流程中最关键的一步。下面我将以最常用的Claude Desktop为例详细拆解每一步。4.1 环境准备与认证配置首先你需要在SolidServer上创建一个API访问令牌Token。通常这需要在SolidServer的Web管理界面中以管理员身份进入“管理”-“API”或类似菜单创建一个新的Token并为其分配合适的权限Role。权限设置的黄金法则遵循最小权限原则。如果这个MCP服务器只用于查询和创建DNS记录那就只授予DNS相关的只读或读写权限不要图省事直接给管理员权限。记下生成的Token ID和Token Secret它们相当于用户名和密码。接下来是获取MCP服务器二进制文件。你有三种选择直接下载发布版本推荐前往项目的GitHub Release页面找到最新版本下载对应你操作系统Windows-amd64.exe Linux-amd64 macOS-darwin-arm64或-amd64的压缩包解压即可得到可执行文件。从源码编译如果你有Go环境并且可能需要进行一些自定义修改可以克隆仓库后执行task go:build。编译产物会出现在./bin/目录下。使用Docker容器项目提供了task image:build命令来构建Docker镜像。这对于希望以容器化方式统一部署的团队非常友好。4.2 Stdio模式与Claude Desktop深度集成这是最典型、最安全的个人使用模式。MCP服务器作为子进程由Claude Desktop启动两者通过标准输入输出stdio进行通信所有数据流都在本地机器上。配置步骤找到Claude Desktop的MCP配置文件位置。通常在以下路径macOS:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.jsonLinux:~/.config/Claude/claude_desktop_config.json如果文件或目录不存在手动创建即可。编辑claude_desktop_config.json文件。你需要将solidserver-mcp的绝对路径和你的SolidServer认证信息配置进去。{ mcpServers: { solidserver: { command: /absolute/path/to/your/solidserver-mcp, env: { SOLIDSERVER_HOST: solidserver.yourcompany.com, SOLIDSERVER_TOKEN_ID: your_actual_token_id_here, SOLIDSERVER_TOKEN_SECRET: your_actual_token_secret_here, SOLIDSERVER_SSL_VERIFY: true, LOG_LEVEL: info } } } }关键配置解析command: 必须是你本地solidserver-mcp二进制文件的绝对路径。在macOS/Linux上可以通过which solidserver-mcp或在文件所在目录执行pwd来获取路径。env: 环境变量字典。SOLIDSERVER_HOST填你的SolidServer实例地址不要带https://前缀。SSL_VERIFY默认为true如果你的SolidServer使用的是自签名证书需要将其设置为false但这会降低安全性生产环境建议配置正确的CA证书。LOG_LEVEL: 设置为debug可以在Claude Desktop的日志中看到详细的请求和响应信息对排查问题非常有帮助正常使用时设为info或warn即可。保存配置文件并完全重启Claude Desktop应用。仅仅关闭窗口可能不够需要从任务栏/程序坞彻底退出再重新启动。验证连接重启后在Claude Desktop的对话窗口中你可以尝试问“你现在有哪些可用的工具”或者“列出我的IPAM空间”。如果配置正确Claude应该能识别出solidserver工具集并成功调用。你也可以查看Claude Desktop的日志文件通常在上述配置文件的同级或父级目录的Logs文件夹内搜索solidserver或MCP关键字来确认服务器是否成功启动。4.3 HTTP模式面向团队的远程服务Stdio模式虽然简单但每个客户端都需要单独配置且可执行文件需在本地。HTTP模式则将MCP服务器作为一个常驻的HTTP服务运行允许多个AI客户端通过网络连接。部署与运行在服务器上设置环境变量并启动服务export MCP_TRANSPORThttp export MCP_HTTP_HOST0.0.0.0 # 监听所有网络接口如果仅本地可改为127.0.0.1 export MCP_HTTP_PORT8080 export SOLIDSERVER_HOSTsolidserver.yourcompany.com export SOLIDSERVER_TOKEN_IDyour_token_id export SOLIDSERVER_TOKEN_SECRETyour_token_secret ./solidserver-mcp服务启动后会监听指定的端口如8080。在AI客户端配置中不再使用command而是使用url。以Cursor IDE为例其MCP配置可能在设置或cursor.json中配置方式类似于{ mcpServers: { solidserver-remote: { url: http://your-mcp-server-host:8080 } } }重要安全警告HTTP模式默认没有传输层加密和认证。这意味着你的SolidServer令牌和所有传输数据在网络上可能是明文的。必须使用HTTPS在生产环境你应该在MCP服务器前部署一个反向代理如Nginx、Caddy配置SSL/TLS证书并将url改为https://...。考虑添加认证你可以在反向代理层配置基础的HTTP认证或者通过防火墙规则严格限制可访问的客户端IP地址。4.4 权限与安全最佳实践无论哪种模式安全都是重中之重令牌隔离为MCP服务器创建专用的API令牌不要复用个人账户或其他系统的令牌。权限最小化在SolidServer中为该令牌配置的角色Role应精确匹配其需要执行的操作。例如一个仅供查询的助手只给只读权限。配置文件安全claude_desktop_config.json文件中包含了密钥应确保该文件的操作系统权限设置正确避免被其他用户读取。网络隔离如果使用HTTP模式确保MCP服务器所在网络与SolidServer之间的通信是安全的且MCP服务本身不被公网直接暴露。日志管理避免在日志中长期记录敏感信息。虽然工具本身可能不会打印完整令牌但调试时仍需谨慎。5. 实战场景从需求到AI执行的完整工作流理论说再多不如看一个完整的例子。假设你是某公司的运维工程师业务部门提来一个需求“我们需要为新的数据分析平台‘DataInsight’搭建一个测试环境网络部门已经划分了VLAN 310网段是172.16.31.0/24。请帮忙分配5个连续的IP地址主机名格式为di-test-node[01-05].lab.example.com并做好DNS解析。”在没有AI助手和MCP之前你可能需要1. 登录SolidServer Web界面。2. 找到对应子网查看空闲IP。3. 手动记录下5个连续IP。4. 逐个创建A记录和PTR记录。5. 可能需要再更新一下内部文档。整个过程可能需要15-30分钟且容易手误。现在有了配置好的solidserver-mcp你可以在Claude Desktop中开启这样一个对话你“Claude我们需要在空间‘上海数据中心’下的子网‘172.16.31.0/24’里找5个连续的空闲IP地址。然后用这些IP为主机di-test-node01到di-test-node05创建A记录域名后缀是.lab.example.com。同时请为它们创建对应的PTR记录。最后把分配结果汇总成一个表格给我。”Claude在背后通过MCP工具执行调用solidserver_space_list确认“上海数据中心”空间存在。调用solidserver_subnet_list并过滤找到“172.16.31.0/24”这个子网获取其ID或完整标识。调用solidserver_ip_find_free传入子网标识和参数count5请求5个连续IP。收到返回的IP列表例如[“172.16.31.101”, “172.16.31.102”, …, “172.16.31.105”]。开始循环处理每个IP和主机名 a. 调用solidserver_ip_create将IP地址在子网中占用分配并可以添加描述如“DataInsight Test Node 01”。 b. 调用solidserver_dns_record_create创建A记录名称di-test-node01.lab.example.com类型A值172.16.31.101。 c. 调用solidserver_dns_record_create创建PTR记录名称101.31.16.172.in-addr.arpa根据IP自动计算反向域名类型PTR值di-test-node01.lab.example.com。 对02-05重复步骤a-c所有操作完成后Claude会整理一个清晰的Markdown表格回复你主机名IP地址状态A记录创建PTR记录创建di-test-node01.lab.example.com172.16.31.101已分配成功成功di-test-node02.lab.example.com172.16.31.102已分配成功成功……………整个交互过程可能只需要2-3分钟而且完全通过自然语言完成。你不需要知道具体的API端点、HTTP方法或JSON格式。AI充当了理解和规划者MCP服务器充当了可靠且准确的执行者。6. 常见问题排查与调试技巧即使配置正确在实际使用中也可能遇到问题。以下是一些常见问题的排查思路和解决方法。6.1 连接与认证失败症状AI助手报告无法连接到工具或者工具执行返回认证错误。检查配置文件路径与格式确保claude_desktop_config.json的JSON格式正确无尾随逗号引号匹配。可以使用在线JSON校验工具验证。验证可执行文件权限在Unix-like系统上确保solidserver-mcp二进制文件有执行权限chmod x solidserver-mcp。确认环境变量特别是SOLIDSERVER_HOST确保是不带http://或https://的纯主机名或IP。可以尝试在终端中手动用export设置相同环境变量后运行solidserver-mcp --help看程序是否能正常启动在Stdio模式下直接运行会等待标准输入可能看起来卡住这是正常的。检查网络连通性与SSL尝试用curl或浏览器访问https://SOLIDSERVER_HOST。如果证书有问题且你确认环境安全可将SOLIDSERVER_SSL_VERIFY设为false临时测试。复核API令牌令牌可能已过期或被撤销。在SolidServer界面检查令牌状态。确保令牌有执行对应操作所需的权限。6.2 工具调用成功但操作失败症状AI能列出工具但执行具体操作如创建IP时返回错误。启用调试日志在配置中设置“LOG_LEVEL”: “debug”重启Claude Desktop。然后在日志中搜索来自solidserver-mcp的条目通常会包含更详细的错误信息例如SolidServer API返回的具体错误码和消息。理解SolidServer错误错误信息是排查的关键。例如“Object already exists”尝试创建已存在的IP或DNS记录。“Insufficient permissions”API令牌权限不足。“Invalid parameter value”传递的参数格式不对比如IP地址格式错误、子网掩码不符合CIDR表示法等。手动API测试使用curl或Postman等工具直接调用SolidServer的REST API使用相同的令牌和参数可以快速定位是MCP服务器的问题还是SolidServer本身的问题。SolidServer的API文档是最终的参考依据。6.3 性能与稳定性考量请求超时对于涉及大量数据查询的操作如列出一个有上万条记录的子网所有IPSolidServer API响应可能较慢导致MCP请求超时。目前MCP协议和客户端可能有默认超时设置。如果遇到此问题可能需要考虑在SolidServer端进行过滤如分页查询或者联系工具开发者看是否支持更细粒度的查询参数。并发操作虽然Go语言并发能力强但需注意SolidServer API本身可能对并发请求有限制。在通过AI执行批量操作时如果速度过快可能会触发SolidServer的速率限制。一个稳妥的做法是在AI的提示词中要求其“逐个执行并确认每一步成功后再进行下一步”或者未来MCP服务器可以实现简单的请求队列。状态一致性网络操作尤其是创建、删除存在中间状态。例如创建IP成功但创建DNS记录失败会导致数据不一致。目前这需要人工介入或通过更复杂的AI工作流创建-验证-回滚来处理。在关键操作后让AI调用一下ip_list或record_list进行验证是一个好习惯。6.4 扩展与自定义当前项目覆盖了主要功能但你可能有一些特定需求缺少某个API功能SolidServer的API非常庞大该项目可能尚未封装所有端点。你可以查阅项目源码了解其如何封装一个工具主要是在internal/tools/目录下然后参照现有模式向项目提交Pull Request来添加新工具。这通常涉及在Go代码中定义新的工具结构体、参数和对应的执行函数。需要复合操作像上面例子中“分配IP并创建DNS记录”是一个常见组合。虽然AI可以串行调用多个工具但有时一个原子性的复合工具更可靠。这同样可以通过修改源码创建一个新的复合工具来实现。输出格式定制你可能希望AI返回特定格式的数据以便直接粘贴到工单系统或CMDB。你可以指导AI对MCP返回的原始JSON数据进行提取和格式化或者修改MCP服务器的工具定义使其返回更结构化的摘要信息。7. 总结与未来展望从我实际配置和使用的体验来看tphakala/solidserver-mcp项目完成度很高它精准地抓住了网络运维工程师在AI时代的新需求将自然语言指令转化为对基础设施的精准操作。它不是一个试图取代专业运维知识的“黑魔法”而是一个极其高效的“翻译官”和“执行者”。它的价值在于将人从重复的、机械的Web界面点击和脚本调试中解放出来让我们能更专注于高层次的网络规划、问题诊断和架构设计。同时由于操作通过AI对话进行整个过程天然形成了可追溯的“操作日志”对于审计和复盘也大有裨益。目前该项目在核心的IPAM和DNS操作上已经相当实用。对于未来的发展我认为有几个可能的方向一是增加更多“策略性”或“批量性”的工具比如基于模板批量创建子网和VLAN二是增强错误处理与状态回滚能力让复杂操作更安全三是或许可以探索与其他配置管理工具如Ansible、Terraform的集成形成更立体的自动化生态。如果你正在使用EfficientIP SolidServer并且日常工作中充斥着类似的网络资源管理任务我强烈建议你花上半小时按照本文的指南配置试用一下。最初的配置可能会遇到一点小挑战但一旦打通你会发现它为你打开了一扇全新效率之门。至少对我来说我再也不愿意回到那个需要手动在多个界面间切换、复制粘贴IP地址的时代了。