MCP Server Demo

Name: MCP Server Demo
Author: hannguyendd

@hannguyendd

Repository

About MCP Server Demo

No overview available yet

#mcp #server #demo

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-demo-hannguyendd": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "\\"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.