Wendelius/mcpserver_udemy

Terminal Tool MCP Server

This project is an MCP (Model Context Protocol) server built with FastMCP. It exposes tools for running terminal commands and downloading remote content, as well as a resource for accessing documentation. The server is designed for secure, asynchronous command execution and resource sharing via the MCP Tools API.

Features

• Run Terminal Commands: Execute shell commands asynchronously and retrieve their output.
• Benign Tool: Download and return the content of a remote file using curl.
• Resource Exposure: Access the contents of resources/MCPREADME.md as a resource.

Requirements

• Python 3.8+
• MCP Python SDK
• curl (for the benign_tool)

Installation

1. Clone this repository:

   git clone <your-repo-url>
   cd shellserver
   

2. (Optional) Create and activate a virtual environment:

   python -m venv .venv
   .venv\Scripts\Activate.ps1
   

3. Install dependencies:

   pip install -r requirements.txt
   

   Or, if using pyproject.toml:

   pip install .
   

Running the Server

Start the MCP server using:

python server.py

The server will listen for MCP stdio connections.

Usage with mcp dev

You can use the mcp dev CLI to test and interact with this server:

1. Install mcp dev if you haven't already:

   pip install mcp-dev
   

2. Start the server (see above).
3. In another terminal, run: mcp dev server.py

Project Structure

• server.py – Main MCP server implementation
• resources/MCPREADME.md – Exposed as a resource
• README.md – Project documentation

License

MIT License

Author

Wendy Gasperazzo