Skip to main content
Glama
pfelilpe

Damn Vulnerable MCP Server Demo

by pfelilpe
README.mdโ€ข3.08 kB
# Damn Vulnerable MCP Server Demo A simplier implementation of a Damn Vulnerable MCP Server that adds two or more numbers ## Overview The MCP Server Demo is a demonstration of excessive agency that could lead to Remote Code Execution (RCE) if the MCP were running on an external server. ๐Ÿ›ก๏ธ ## Features - ๐Ÿš€ Basic MCP server implementation. - ๐Ÿ“‚ Demonstrates server functionality with `server.py`. ## Warning โš ๏ธ This project is a **vulnerable MCP server** designed to demonstrate how poor implementation practices can lead to security issues. It is intended for educational purposes only. โŒ **Do not use this project in production environments.** ## Prerequisites - ๐Ÿ Python 3.10 or higher. - ๐Ÿ’ก A virtual environment is recommended for managing dependencies. ## Installation 1. ๐Ÿ“ฅ Clone the repository: ```bash git clone <repository-url> cd DVMCP ``` 2. ๐Ÿ“ฆ Install dependencies: ```bash pip install -r requirements.txt ``` ## Usage 1. โ–ถ๏ธ Link the MCP Server with Copilot: ```bash vscode://settings/mcp ``` 2. Add the server configuration to the `settings.json` file in VS Code: ```json "servers": { "DVMCP": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "mcp", "run", "/Users/pfelilpe/Documents/DVMCP/server.py" ], "env": {} } } ``` 3. Click on **Start Server**. 4. Interact with Copilot in Agent mode, for example: ``` 1+1 with addition ``` 5. Experiment with code injection to explore potential OS Injection vulnerabilities... ๐Ÿ•ต๏ธโ€โ™‚๏ธ 6. You can find a safer implementation of this simpler MCP at `/safe/server.py`. ๐Ÿ”’ ## Adding MCP to Your Python Project We recommend using `uv` to manage your Python projects. ๐Ÿ› ๏ธ If you haven't created a `uv`-managed project yet, initialize one: ```bash uv init mcp-server-demo cd mcp-server-demo ``` Then add MCP to your project dependencies: ```bash uv add "mcp[cli]" ``` Alternatively, for projects using `pip` for dependencies: ```bash pip install "mcp[cli]" ``` ## Running the Standalone MCP Development Tools To run the `mcp` command with `uv`: ```bash uv run mcp ``` ## Project Structure - `server.py`: ๐Ÿ–ฅ๏ธ Main server implementation. - `pyproject.toml`: ๐Ÿ“œ Project configuration file. - `README.md`: ๐Ÿ“– Documentation for the project. - `uv.lock`: ๐Ÿ”’ Lock file for dependencies. - `__pycache__/`: ๐Ÿ—‚๏ธ Contains compiled Python files. ## Contributing ๐Ÿค Contributions are welcome! Please fork the repository and submit a pull request with your changes. ## License ๐Ÿ“„ This project is licensed under the terms of the LICENSE file in the root directory. ## Created by pfelilpe ## Buy Me a Coffee If you found this project helpful or interesting, consider buying me a coffee to support my work: โ˜•๏ธ [![Buy Me a Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/pfelilpe)

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pfelilpe/DVMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server