Cisco Nso MCP Server

🚀 Cisco NSO MCP サーバ

Cisco NSO（ネットワークサービスオーケストレータ）用の Model Context Protocol (MCP) サーバの実装です。自然言語による対話を通じて、AI 駆動のネットワーク自動化を実現します。

🚀 クイックスタート

このパッケージは、Cisco NSO 用の独立した MCP サーバを提供します。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 の 2 種類のトランスポートタイプをサポートしています。

標準設定

デフォルトでは、サーバは 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