Cisco NSO MCP 服务器

一个用于 Cisco NSO（网络服务编排器）的 Model Context Protocol (MCP) 服务器实现，通过自然语言交互实现 AI 驱动的网络自动化。

概述

此包提供了一个独立的 MCP 服务器，适用于 Cisco NSO，使用 Python 编写，可以使用 pip 安装并作为命令行工具运行。它将 Cisco NSO 的功能暴露为 MCP 工具和服务，这些工具和服务可以被任何 MCP 兼容客户端消费。

# 安装包
pip install cisco-nso-mcp-server

# 运行服务器
cisco-nso-mcp-server

什么是 MCP？

Model Context Protocol (MCP) 是一种开放协议，标准化了 AI 模型与外部工具和服务之间的交互方式。MCP 实现：

• 工具定义：结构化地定义 AI 模型可以使用工具的方式
• 工具发现：模型发现可用工具的机制
• 工具执行：模型调用工具并接收结果的标准方法
• 上下文管理：在工具和模型之间高效传递上下文
• 框架无关：适用于 OpenAI、Anthropic、Google Gemini 等多个 AI 框架
• 互操作性：为 AI 系统与外部工具之间的通信提供通用语言

MCP 的灵活性说明

尽管 MCP 的主要用例是与 LLM 集成，但 MCP 和类似的工具框架（如 Smithery）是 LLM 无关的——它们只是特定协议的 API。这意味着你可以：

• 直接使用：在没有 LLM 的任何应用程序中直接使用
• 通过集成层让 LLM 控制：通过集成层让 LLM 控制
• 根据需要混合两种方法：根据具体需求和用例混合两种方法

这种灵活性使 MCP 工具超越了仅限于 LLM 应用程序的价值，成为在工具和服务之间进行通信的通用工具。

安装与运行

安装

使用 pip 安装：

pip install cisco-nso-mcp-server

运行服务器

运行 MCP 服务器：

cisco-nso-mcp-server

配置选项

MCP 服务器支持两种传输类型：stdio 和 sse。

标准配置

默认情况下，服务器使用 stdio 传输。如果你想要更改传输类型或 SSE 传输的主机和端口，请参考以下命令：

使用标准配置运行服务器

cisco-nso-mcp-server --transport stdio

更改 SSE 传输的主机和端口

cisco-nso-mcp-server --transport sse --host 0.0.0.0 --port 8000

环境变量优先级

环境变量的值会覆盖默认值，但会被命令行参数覆盖。

连接到服务器

标准输入输出传输（stdio）

对于 stdio 传输，你需要启动服务器进程并通过 stdin 和 stdout 进行通信：

from mcp import ClientSession, StdioServerParameters
from contextlib import AsyncExitStack

async def connect():
    exit_stack = AsyncExitStack()
    server_params = StdioServerParameters(
        command="cisco-nso-mcp-server",
        args=[],
        env=None
    )
    
    stdio_transport = await exit_stack.enter_async_context(stdio_client(server_params))
    stdio, write = stdio_transport
    session = await exit_stack.enter_async_context(ClientSession(stdio, write))
    await session.initialize()
    
    # 现在你可以使用会话调用工具和读取资源
    return session

SSE 传输

对于 SSE 传输，你可以通过标准 HTTP 客户端连接到服务器：

from mcp import ClientSession, SSEServerParameters
from contextlib import AsyncExitStack

async def connect():
    exit_stack = AsyncExitStack()
    server_params = SSEServerParameters(
        url="http://localhost:8000",
        headers={"Authorization": "Bearer YOUR_TOKEN"}
    )
    
    sse_transport = await exit_stack.enter_async_context(sse_client(server_params))
    session = await exit_stack.enter_async_context(ClientSession(sse_transport))
    await session.initialize()
    
    # 现在你可以使用会话调用工具和读取资源
    return session

异步实现细节

MCP 服务器利用 Python 的异步编程功能来高效处理网络操作：

• 异步函数定义：所有工具函数都使用 async def 定义为协程
• 非阻塞 I/O：对 Cisco NSO 的网络调用包装在 asyncio.to_thread() 中，以防止阻止事件循环
• 并发处理：多个工具调用可以同时处理而无需等待之前操作完成
• 错误处理：异步 try/except 块捕获并正确格式化来自网络操作的错误

许可证

MIT License