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:
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentic_terminal_station-0.2.0.tar.gz.
File metadata
- Download URL: agentic_terminal_station-0.2.0.tar.gz
- Upload date:
- Size: 9.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ce3639f384bce79f3b30f3740960121f47a337b2826001c96ccdeb28e36ab2e7
|
|
| MD5 |
fc7d4c1733fd2e2a0e2ded8dcc90319b
|
|
| BLAKE2b-256 |
f6440bbb6fb2f00f090d5bbd21a6112b5533c5310080fbfe0b6d2c03dd228320
|
File details
Details for the file agentic_terminal_station-0.2.0-py3-none-any.whl.
File metadata
- Download URL: agentic_terminal_station-0.2.0-py3-none-any.whl
- Upload date:
- Size: 8.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
18c9fc45f88bfea43959bf8ce777b42b01f74d6c0021cc7d8797da4415bc3c18
|
|
| MD5 |
a5cf94109d898795a85443855cae767d
|
|
| BLAKE2b-256 |
91ed3b118ff48755ab93ff1119bea11de2e336508ef3968d11f8a1b1a914ca03
|
