mcpField
T
Terminal Tool MCP Server

Terminal Tool MCP Server

Local
github.com/WendeliusDeveloper Tools0Updated 74w ago
Repository

About Terminal Tool MCP Server

Terminal Tool MCP Server is a FastMCP server for clients that need terminal command execution and documentation access. It also provides a tool to download remote file content and accepts stdio connections.

Key features

  1. 01Run shell commands asynchronously
  2. 02Download remote content with curl
  3. 03Expose the MCPREADME.md resource

Use cases

  1. 01Run commands and inspect their output
  2. 02Retrieve remote file content through a tool
  3. 03Provide project documentation to clients

MCP support

It exposes tools for terminal commands and remote content downloads, plus the MCPREADME.md resource to MCP clients. It supports stdio connections.

#mcpserver#terminal-tool#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.