✨🤖 Cisco RADKit MCP Server
A stand-alone MCP server built with FastMCP that exposes key functionalities of the Cisco RADKit SDK as MCP tools.
It is designed to be connected to any MCP client and LLM of your choice, enabling intelligent interaction with network devices through Cisco RADKit.
免责声明：此MCP服务器不是思科官方产品。它是为实验和学习目的而开发的。
🚀 概述
此MCP服务器充当 思科RADKit 服务和A MCP兼容客户端.\ 它允许LLM检查RADKit清单中登录的设备并与之交互，获取设备属性，甚至执行CLI命令——所有这些都是通过结构化的MCP工具完成的。
⚙️ 特性
- 🔌 即插即用MCP服务器 --适用于任何兼容MCP的客户端。
- 🔍 库存发现 --列出所有已登录的网络设备。
- 🧠 设备自检 --获取设备属性和功能。
- 🖥️ 命令执行 --在网络设备上运行CLI命令。
- 📦 完全键入提示工具 为了清晰和可扩展性。
📚 包含的图书馆
文件中提到了所有必需的库 requirements.txt包括其固定版本。
cisco_radkit_client==1.9.0cisco_radkit_common==1.9.0cisco_radkit_service==1.9.0fastmcp==2.13.1
🧰 暴露的MCP工具
| 工具名称 | 描述 | 输入 | 返回 | 用例 |
|---|---|---|---|---|
get_device_inventory_names() | 返回一个字符串，其中包含Cisco RADKit资源清册中已登录设备的名称。 | *无* | str：车载设备列表（例如。 {"p0-2e", "p1-2e"}) | 当用户询问“设备”、“网络”或“所有设备”时，请先使用此选项。 |
get_device_attributes(target_device: str) | 以JSON格式返回特定设备的详细信息。 | target_device (str)：目标设备名称。 | str：JSON，属性包括名称、主机、类型、配置、SNMP/NETCONF状态、功能等。 | 当用户询问特定设备时，请使用此选项。 |
exec_cli_commands_in_device(target_device: str, cli_command: str) | 在目标设备上执行一个或多个CLI命令，并返回原始文本结果。 | target_device (str)：设备名称。 | ||
cli_commands ([str])：要执行的一个或多个CLI命令。 | str：执行命令的原始输出。 | 仅当信息在中不可用时才使用此选项 get_device_attributes() 或者当明确要求“运行”或“执行”命令时。 |
🧩 需求
- Python 3.10+
- 主动思科RADKit服务
- Cisco RADKit服务中至少有一个只读/RW用户登录
有关设置Cisco RADKit服务的更多信息，请访问 此链接.
🛠️ 安装
在部署环境中克隆存储库。
git clone https://github.com/ponchotitlan/radkit-mcp-server.git
cd radkit-mcp-server⚙️ 设置
根据您的主机操作系统类型在终端中执行附带的助手脚本：
🐧🍎 Linux/MacOS：
chmod +x setup.shbash setup.sh🪟 窗户：
setup.bat助手将首先创建一个虚拟环境文件夹 radkit mcp服务器/.vev/ 需要所有python库。之后，它将触发以下助手：
╭─────────────────────────────────────────╮
│ 🚀 Cisco RADKit MCP Server Utility Tool │
╰─────────────────────────────────────────╯
? Choose an option: (Use arrow keys)
» 1. 👾 Onboard user to non-interactive Cisco RADKit authentication
2. 📚 Generate .env file for Cisco RADKit MCP server
Exit👾 1.非交互式Cisco RADKit身份验证设置
MCP服务器使用证书登录来避免每次使用工具时都要求进行Web UI身份验证。为此，需要在主机中生成证书。选择第一个选项并按照说明进行操作。
╭─────────────────────────────────────────╮
│ 🚀 Cisco RADKit MCP Server Utility Tool │
╰─────────────────────────────────────────╯
? Choose an option: 1. 👾 Onboard user to non-interactive Cisco RADKit authentication
? Enter Cisco RADKit username: ponchotitlan@cisco.com
╭───────────────────────────────────────────────────────────────────╮
│ Starting Cisco RADKit onboarding for user: ponchotitlan@cisco.com │
╰───────────────────────────────────────────────────────────────────╯
A browser window was opened to continue the authentication process. Please follow the instructions there.
Authentication result received.
New private key password: ***********
Confirm: ***********
The private key is a very sensitive piece of information. DO NOT SHARE UNDER ANY CIRCUMSTANCES, and use a very strong passphrase. Please consult the documentation for more details.
:891: UserWarning: The private key is a very sensitive piece of information. DO NOT SHARE UNDER ANY CIRCUMSTANCES, and use a very strong passphrase. Please consult the documentation for more details.注意提供的密码，因为第二个选项需要密码！
现在，选择第二个选项：
📚 2.生成.env文件
提供所要求的信息。密码是第一个选项中刚刚设置的密码。
? Choose an option: 2. 📚 Generate .env file for Cisco RADKit MCP server
╭───────────────────────────────────────────────────────────────────────────────╮
│ Warning: Make sure Cisco RADKit certificates for this username already exist. │
│ If not, run the onboarding process first using option 1. │
╰───────────────────────────────────────────────────────────────────────────────╯
? Enter Cisco RADKit username: ponchotitlan@cisco.com
? Enter Cisco RADKit service code: aaaa-bbbb-cccc
? Enter non-interactive authentication password: ***********此MCP服务器同时支持 stdio 和 https 运输方式。出现提示时，选择要使用的选项：
? Select MCP transport mode: (Use arrow keys)
» stdio
https默认选项为 stdio否则，如果 https 如果选中，系统将提示您输入以下信息：
? Select MCP transport mode: https
? Enter MCP host: 0.0.0.0
? Enter MCP port: 8000
╭──────────────────────────────────────╮
│ ✅ .env file generated successfully! │
│ Saved as .env │
╰──────────────────────────────────────╯文件 radkit mcp服务器/.env 使用MCP服务器所需的环境变量生成。
✅ 您的MCP服务器已准备好使用！
⚡️ 使用示例：Claude Desktop
Claude Desktop应用程序提供了一个集成了Claude LLM和与此MCP服务器兼容的丰富MCP客户端的环境。
要开始，请下载 Claude桌面应用程序 对于您的主机操作系统，请选择最适合您需求的LLM使用计划。
之后，编辑 radkit-mcp服务器/claude_desktop_config json 此存储库中包含的文件指向 绝对路径 你的 _.venv_ 和 _mcp_server.py_ 文件夹：
{
"mcpServers": {
"radkit-mcp-server": {
"command": "/Users/ponchotitlan/Documents/radkit-mcp-server-community/.venv/bin/python",
"args": [
"/Users/ponchotitlan/Documents/radkit-mcp-server-community/mcp_server.py"
],
"description": "Cisco RADKit MCP Server - Community"
}
}
}然后，将此文件复制到Claude Desktop应用程序配置的位置。目录因主机操作系统而异：
🍎 MacOS：
cp claude_desktop_config.json ~/Library/Application\ Support/Claude 🪟 窗户：
cp claude_desktop_config.json %APPDATA%\Claude\🐧 Linux：
cp claude_desktop_config.json ~/.config/Claude/现在，重新启动您的Claude Desktop应用程序。之后，如果您导航到 配置/开发人员/，您应该看到MCP服务器已启动并正在运行：
✨ 提示示例
📚 显示Cisco RADKit服务的清单
MCP服务器工具之一提供设备名称列表。
🎰 询问有关设备的具体问题
另一个MCP服务器工具提供设备的信息（如果可以直接在Cisco RADKit SDK中获得）。
否则，通过MCP服务器工具在设备中执行命令以获取所需信息。
🗺️ 使用网络数据进行复杂查询
LLM可以使用来自多个数据网络查询的信息来构建例如拓扑图。
稍后可以根据需要使用来自网络的更多信息来细化此图。
⬇️ 推送配置
并非所有信息都是查询信息！ 如果MCP服务器中登录的Cisco RADKit用户启用了写权限，可以进行提交操作。
这些只是使用此MCP服务器可以完成的一些示例！
______________________________________________________________________
Made with ☕️ by Poncho Sandoval - Developer Advocate 🥑 @ DevNet - Cisco Systems 🇵🇹