Metadata-Version: 2.4
Name: agentic-terminal-station
Version: 0.2.0
Summary: An MCP server that gives an agent terminal capabilities: run shell commands, run Python, and manage files.
Author-email: Manickandan Govindarajan <manickandan@gmail.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=3.4.7
Dynamic: license-file

# agentic-terminal-station

An MCP (Model Context Protocol) server that gives an agent terminal
capabilities: run shell commands, run Python code, and read/write files and
folders on the host machine.

## ⚠️ Security warning

This server lets any connected MCP client execute **arbitrary shell commands
and Python code** on the machine it runs on, with no sandboxing, allowlisting,
or confirmation step. Only run it locally, only connect it to clients you
trust, and never expose it over a network or to an untrusted agent.

## Install

```
pip install agentic-terminal-station
```

Or with [uv](https://docs.astral.sh/uv/):

```
uv add agentic-terminal-station
```

Or run it as a one-off tool without adding it to a project:

```
uvx agentic-terminal-station
```

## Usage

Run the server (defaults to stdio transport, for use with an MCP client):

```
agentic-terminal-station
```

Choose a different transport:

```
agentic-terminal-station --transport http
```

See all options:

```
agentic-terminal-station --help
```

## Tools provided

| Tool | Description |
| --- | --- |
| `bash` | Run a shell command and return its output. |
| `python_code` | Run a string of Python code and return its output. |
| `python_file` | Run a Python file and return its output. |
| `glob` | List files matching a glob pattern. |
| `grep` | Search for a pattern in a file (Windows only, uses `findstr`). |
| `read_file` | Read a file's contents. |
| `write_file` | Write content to a file. |
| `create_folder` | Create a folder. |
| `delete_folder` | Delete a folder and its contents. |
| `list_dir` | List entries in a folder (defaults to the current directory). |
| `delete_file` | Delete a file. |
| `copy_file` | Copy a file from source to destination. |
| `move_file` | Move or rename a file or folder. |
| `cwd` | Get the current working directory. |
| `file_exists` | Check whether a file or folder path exists. |
| `file_info` | Get a file/folder's size, modified time, and whether it's a directory. |
| `get_env` | Read an environment variable. |
| `set_env` | Set an environment variable for the running server process. |

## Requirements

- Python >= 3.13

## License

MIT — see [LICENSE](LICENSE).
