Terminal Tool MCP Server
About
Terminal Tool MCP Server is an MCP (Model Context Protocol) server built with FastMCP that exposes tools for running terminal commands and downloading remote content, as well as a resource for accessing documentation. It is designed for secure, asynchronous command execution and…
Details
- Author
- Wendelius
- Downloads
- 278
- Categories
- Developer Tools
Jump to
- Execute shell commands asynchronously via MCP tools.
- Download and return remote content using curl.
- Expose resources/MCPREADME.md as an accessible resource.
- Uses MCP stdio transport for secure communication.
- Simple setup with Python and pip.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Terminal Tool MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python 3.8+, the MCP Python SDK, and curl (for the benign tool). Clone the repository, optionally create a virtual environment, run pip install -r requirements.txt, then start the server with python server.py. For interactive testing, use the mcp dev CLI by running mcp dev server.py in another terminal.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"terminal tool mcp server": {
"terminal-tool-mcp-server": {
"command": "python",
"args": [
"server.py"
]
}
}
}
}McpServers
{
"terminal-tool-mcp-server": {
"command": "python",
"args": [
"server.py"
]
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
