# MCP Terminal Tool Server
This is a simple MCP server built with the MCP Python SDK. It exposes a single tool called `terminal_tool` that allows users to run terminal commands and returns their output.
## Requirements
- Python 3.8+
- MCP Python SDK (`pip install mcp-sdk`)
## Running the Server
```bash
python server.py
```
## Exposed Tool
### terminal_tool
- **Description:** Run a terminal command and return its output as a string.
- **Arguments:**
- `command` (str): The terminal command to execute.
- **Returns:**
- Output of the command as a string (stdout or stderr).
---
**Note:** Use with caution. This tool executes arbitrary shell commands on the server.
## MCP Inspector & Claude Configuration
To connect this server to the MCP Inspector, Claude (Anthropic), or other MCP-compatible clients, use a configuration like the following:
```json
{
"mcpServers": {
"terminal_tool": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/project",
"run",
"server.py"
]
}
}
}
```
- Replace `/path/to/your/project` with the absolute path to your project directory.
- This configuration will launch the server using `uv` and connect via stdio transport (default).
- **Claude (Anthropic) users:** You can add this configuration to your Claude MCP settings to enable tool use with your local server.
- For HTTP transport, start the server manually with `python server.py` (or `uv run server.py`) and connect to the appropriate URL in the Inspector.
