DevNetコンテンツ検索MCPサーバーの起動

Web での検索から IDE での検索へ

昨年私たちが立ち上げた AI 主導のセマンティック検索 Meraki API ドキュメントについては、developer.cisco.com にあります。ただし、開発者はブラウザではなく IDE に住んでいます。適切なコンテキストがないと、IDE の AI アシスタントはコードを生成するときに、古い知識や一般的な知識にフォールバックしてしまいます。

の DevNet コンテンツ検索 MCP サーバー はその進化の次のステップです。developer.cisco.com を強化するのと同じセマンティック検索を採用し、 IDE内で、AI アシスタントがリアルタイムで使用できます。 MCP (Model Context Protocol) は、IDE AI アシスタントがライブ ツールを呼び出す (この場合は Cisco API ドキュメントを検索する) ことを可能にする標準であり、ウィンドウを切り替えることなく正確な現在のコンテキストを取得できます。ワンクリックでインストールでき、何も設定する必要はありません。IDE はコードの提案を基にできるようになります。 公式 Cisco API 仕様 時代遅れの知識や一般的な知識の代わりに。

現在、サーバーはサポートしています Meraki とカタリスト センター API ドキュメント。さらに多くの Cisco 製品と DevNet コンテンツを拡大していきます。製品の API を含めたいですか? 問題を作成する それを要求するために。

ワンクリックインストール、ライブAPI検索

の DevNet コンテンツ検索 MCP サーバー ワンクリックでインストールできる VSコード または カーソル—環境は準備ができており、何も設定する必要はありません。サーバーはブラウザの代わりにはなりません。これにより、DevNet の適切なスライスがコーディング フローに組み込まれます。

インストールしたら、IDE チャット パネルからクエリを実行してください。たとえば、次のようになります。 「トラフィック ルールを構成するための Meraki L3 ファイアウォール API エンドポイントを見つける」 または 「デバイス インベントリ管理用の Catalyst Center API を見つける」—AI アシスタントがライブ ドキュメントを取得し、それを応答に使用する様子を確認します。

ボンネットの下には何があるのか

MCP サーバーが公開する 3つのツール IDE の AI アシスタントが呼び出して、その答えを DevNet に根付かせることができます。

• Meraki API ドキュメントの検索 — Meraki API ドキュメントを介した自然言語セマンティック検索。わかりやすい言葉で尋ねてください。サーバーは、名前、説明、API パス、メソッド、操作 ID、および公式ドキュメントへのリンクを含む一致するエンドポイントを返します。
• Meraki API オペレーション ID の検索 — OpenAPI オペレーション ID がすでにわかっている場合 (例: createNetworkMerakiAuthUser)、このツールは正確なエンドポイントの詳細と仕様を返します。検証や、特定の操作を対象とするコードの生成に役立ちます。
• Catalyst Center API ドキュメントの検索 — Catalyst Center API の同じセマンティック検索: エンタープライズ ネットワーク管理、デバイスのオンボーディング、保証、コンプライアンス、および関連するユースケース。

応答は、AI アシスタントが確実に抽出できるように構造化されています。 api_path、 api_method、 api_operation_id、 そして documentation_url 生成されたコード内でそれらを引用します。返された文書は、権力を行使するのと同じ真実の情報源です。 開発者.cisco.com/docs– 出力を実際の API サーフェスに関連付けたままにし、IDE が生成するものを簡単に検証できるようにします。

検索を超えて: 参照ワークフローとプロンプト

MCP サーバーは、大規模なワークフローの一部である場合に最も役立ちます。つまり、最新の API 詳細を取得し、同じフロー内でコードを生成または調整します。それがどのようなものかを示すために、以下を提供します 参照サンプル ワークフローとプロンプト定義 GitHub リポジトリには、ドキュメンテーションファーストのアプローチを示す Meraki と Catalyst Center のサンプル構成が含まれています。コードを生成する前に MCP 検索ツールを呼び出し、出力を「単純なスクリプト」と「エンタープライズ スタイル」のパターンに合わせて調整します。プロンプトの例には、ネットワーク ID の取得、孤立したデバイスの検出、ファームウェア アップグレードのスケジュールなどのタスクが含まれています。

これらは参考サンプルのみです– 認定された製品や本番環境に対応した製品ではなく、独自の環境に適応するための出発点となります。

AI によって生成されたコードに関するメモ: AI アシスタントからの出力は、この MCP サーバーを使用しているかどうかに関係なく、不完全、不正確、または安全でない可能性があります。生成されたコードは、後輩からのドラフトと同じように扱います。実際の環境で実行する前に、レビュー、テスト、承認を行ってください。私たちはこれを真剣に受け止めており、それが私たちが次に向かう方向を形作ります。

次は何だろう

今回のリリースの目的は 1 つです。それは、IDE の前に適切な API コンテキストを配置して、品質を強固な基盤から開始できるようにすることです。ここから先は 2 つのトラックがあります。

1. より広い範囲をカバーします。 現在、このサーバーは Meraki と Catalyst Center API をカバーしています。これをより多くのシスコ製品 API やその他の DevNet コンテンツ (ラーニング ラボ、コード サンプル、サンドボックス リファレンス) に拡張し、IDE が API 仕様だけでなく、より多くの DevNet を使用できるようにします。

2. 参考サンプルから開発者のスキルまで。 本日出荷するワークフローとプロンプトは参考サンプルです。次のステップは、それらを次のように進化させることです。 開発者のスキル: ベスト プラクティス、セキュリティ ガイドライン、コーディング標準が組み込まれた、厳選され検証された構成。私たちはまだそこに到達していませんが、その進捗については透明性を持っていきます。

あなたのフィードバックは、どの API を最初に追加するか、どのユースケースを優先するか、そしてサンプルをどのように成熟させるかという両方のトラックを形成します。ご招待します 試してみてください、フィードバックを共有し、 教えてください 次に知りたい製品 API とユースケース。

インストール (ワンクリック): VSコード · カーソル

ドキュメントとフィードバック: GitHub リポジトリ · 追加の API をリクエストする