MCP Server Demo

What is MCP Server Demo?

MCP Server Demo is a demonstration implementation of a Model Context Protocol (MCP) server that provides a tool to upgrade applications by executing a shell script. It communicates via stdio transport and is intended for developers exploring MCP integrations.

How to use MCP Server Demo?

Install dependencies with uv pip install -e . and create a .env file with COMMAND_FOLDER_PATH pointing to the folder containing update-apps.sh. Run the server with python main.py or integrate it with the VS Code MCP extension using the provided mcp.json configuration. For testing, use the MCP Inspector via npx @modelcontextprotocol/inspector uv --directory ${PWD} run main.py.

Key features of MCP Server Demo

• Exposes a single tool upgrade_apps that runs a shell script.
• Relies on an environment variable for the script’s folder path.
• Uses stdio transport for client-server communication.
• Configurable via .env file and uv package management.
• Compatible with VS Code MCP extension and MCP Inspector.

Use cases of MCP Server Demo

• Testing and demonstrating an MCP server with a custom tool.
• Automating application upgrades by triggering a shell script from an MCP client.
• Learning how to structure a FastMCP server with subprocess execution.

FAQ from MCP Server Demo

What does MCP Server Demo do?

It is a demonstration MCP server that provides a single tool, upgrade_apps, which executes the update-apps.sh script located in the folder specified by the COMMAND_FOLDER_PATH environment variable.

What are the prerequisites for running MCP Server Demo?

Python 3.12 or higher, the uv package manager, and a .env file with the COMMAND_FOLDER_PATH variable set to the folder containing update-apps.sh.

How do I run MCP Server Demo?

Run python main.py directly, or use the VS Code MCP extension with the provided mcp.json configuration, or test it with the MCP Inspector using npx @modelcontextprotocol/inspector uv --directory ${PWD} run main.py.

What transport does MCP Server Demo use?

It uses stdio transport for communication between the server and MCP-compatible clients.

Where does MCP Server Demo store or look for data?

It reads the COMMAND_FOLDER_PATH environment variable to locate the folder containing the update-apps.sh script; no other persistent data storage is mentioned.