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…
Explore
- 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.
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
- Python 3.8+
- MCP Python SDK
- curl (for the benign_tool)
Start the MCP server using:
python server.py
The server will listen for MCP stdio connections.
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
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.
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"
]
}
}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.
