DVMCP

🚀 脆弱性のあるMCPサーバーデモ

2つ以上の数を加算する、脆弱性のあるMCPサーバーのシンプルな実装です。

🚀 クイックスタート

このMCPサーバーデモは、MCPが外部サーバーで実行されている場合に、過剰なエージェント機能がリモートコード実行（RCE）につながる可能性を示します。 🛡️

✨ 主な機能

• 🚀 基本的なMCPサーバーの実装。
• 📂 server.py を使用したサーバー機能のデモ。

⚠️ 重要提示

このプロジェクトは、実装方法が不適切な場合にセキュリティ問題につながる可能性を示すための、脆弱性のあるMCPサーバーです。教育目的のみを意図しています。

❌ 本番環境でこのプロジェクトを使用しないでください。

📦 インストール

前提条件

• 🐍 Python 3.10 以上。
• 💡 依存関係の管理には仮想環境の使用をおすすめします。

手順

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

   git clone <repository-url>
   cd DVMCP
   

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

   pip install -r requirements.txt
   

💻 使用例

基本的な使用法

1. ▶️ MCPサーバーをCopilotとリンクします：

   vscode://settings/mcp
   

2. VS Codeの settings.json ファイルにサーバー設定を追加します：

   "servers": {
       "DVMCP": {
           "command": "uv",
           "args": [
               "run",
               "--with",
               "mcp[cli]",
               "mcp",
               "run",
               "/Users/pfelilpe/Documents/DVMCP/server.py"
           ],
           "env": {}
       }
   }
   

3. Start Server をクリックします。

4. エージェントモードでCopilotと対話します。例えば：

   1+1 with addition
   

5. コードインジェクションを試して、潜在的なOSインジェクションの脆弱性を調査します... 🕵️‍♂️

6. このシンプルなMCPのより安全な実装は /safe/server.py にあります。 🔒

高度な使用法

PythonプロジェクトへのMCPの追加

uv を使用してPythonプロジェクトを管理することをおすすめします。 🛠️

まだ uv で管理されたプロジェクトを作成していない場合は、初期化します：

uv init mcp-server-demo
cd mcp-server-demo

次に、プロジェクトの依存関係にMCPを追加します：

uv add "mcp[cli]"

あるいは、pip を使用して依存関係を管理するプロジェクトの場合は：

pip install "mcp[cli]"

スタンドアロンのMCP開発ツールの実行

uv で mcp コマンドを実行するには：

uv run mcp

📚 ドキュメント

プロジェクト構造

• server.py: 🖥️ メインのサーバー実装。
• pyproject.toml: 📜 プロジェクトの設定ファイル。
• README.md: 📖 プロジェクトのドキュメント。
• uv.lock: 🔒 依存関係のロックファイル。
• __pycache__/: 🗂️ コンパイルされたPythonファイルが含まれています。

コントリビュート

🤝 コントリビューションは大歓迎です！ リポジトリをフォークし、変更を加えたプルリクエストを送信してください。

📄 ライセンス

このプロジェクトは、ルートディレクトリの LICENSE ファイルの条件に基づいてライセンスされています。

作成者: pfelilpe

コーヒーを奢る

このプロジェクトが役に立ったり面白かったりした場合は、私の活動を支援するためにコーヒーを奢ってください： ☕️