# Shell Server

A simple MCP server that exposes a `terminal` tool, allowing AI agents to execute shell commands.

## Requirements

- Python 3.10+
- [uv](https://docs.astral.sh/uv/)

## Setup

```bash
uv venv
uv sync
```

## Running

```bash
uv run server.py
```

Or during development with the MCP inspector:

```bash
uv run mcp dev server.py
```

## Tool

### `terminal`

Executes a shell command and returns its output.

**Input**

| Parameter | Type   | Description                  |
|-----------|--------|------------------------------|
| `command` | string | The shell command to execute |

**Output**

```json
{
  "stdout": "...",
  "stderr": "...",
  "return_code": 0
}
```

## Connecting to Cursor

Add the following to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "shellserver": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/sami/Documents/MCP/mcp-servers/shellserver",
        "run",
        "server.py"
      ]
    }
  }
}
```

Then restart Cursor. The `terminal` tool will be available to the Agent.

## Security

This server executes arbitrary shell commands. Only run it locally and never expose it over a network.