Netwhisper Remote MCP Server

Netwhisper リモート MCP サーバー

ネットワークデバイスとのやり取りを可能にするリモート MCP サーバーです。

概要

Netwhisper リモート MCP サーバーは、Cloudflare Workers ベースの Model Context Protocol（MCP）サーバー実装です。ネットワークデバイスとやり取りするツール、設定の詳細を取得するツール、デバイス設定をリモートで管理するツールを提供します。サーバーは OAuth ベースの認証に対応し、MCP Inspector や Claude Desktop などのツールとシームレスに統合できます。

特長

• MCP ツール：ネットワークデバイスとやり取りする get_facts、get_config、add_static_route などのツールが含まれています。
• OAuth 認証：OAuth を使用してサーバーへのアクセスを安全に保護します。
• Cloudflare Workers：スケーラビリティとパフォーマンスを高めるため、Cloudflare Workers にデプロイされています。
• KV ストレージ：OAuth 関連データの保存に Cloudflare KV を使用します。
• Durable Objects：状態を維持するやり取りに Durable Objects を実装しています。

ローカル開発

サーバーをローカルで開発およびテストする手順は次のとおりです。

1. リポジトリをクローンします。

   git clone [email protected]:pmesgari/netwhisper-mcp-server.git
   cd netwhisper-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. サーバーをローカルで実行します。

   npm start
   

4. ブラウザーでサーバーを開きます。 http://localhost:8787/

MCP Inspector の使用

MCP API を確認するには、MCP Inspector を使用します。

1. Inspector を起動します。

   npx @modelcontextprotocol/inspector
   

2. Inspector を設定します。

   • Transport Type を SSE に設定します。
   • URL として http://localhost:8787/sse を入力します。
   • 「Connect」をクリックします。

3. 任意のメールアドレスとパスワードでログインして、ツールにアクセスします。

Claude Desktop への接続

サーバーを Claude Desktop に接続する手順は次のとおりです。

1. Claude の設定ファイルを更新します。

    {
      "mcpServers": {
        "netwhisper": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "http://localhost:8787/sse"
          ]
        }
      }
    }
   

2. Claude Desktop を再起動し、ツールを利用できることを確認します。

Cloudflare へのデプロイ

サーバーを Cloudflare Workers にデプロイする手順は次のとおりです。

1. KV 名前空間を作成します。

   npx wrangler@latest kv namespace create remote-mcp-server-oauth-kv
   

2. KV 名前空間 ID を wrangler.jsonc に追加します。

3. サーバーをデプロイします。

   npm run deploy
   

4. workers.dev の URL でデプロイ済みサーバーにアクセスします。

デバッグ

• 問題が発生した場合は、Claude を再起動するか、~/.mcp-auth ディレクトリをクリアします。

  rm -rf ~/.mcp-auth
  

• MCP Inspector を使用してサーバーをテストします。

  npx mcp-remote http://localhost:8787/sse
  

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。