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
Metadata
1 maintainer
Release files for agentic-terminal-station 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| agentic_terminal_station-0.2.0.tar.gz | 9.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agentic_terminal_station-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 18.7 kB
Release files / agentic_terminal_station-0.2.0.tar.gz
| Download URL | agentic_terminal_station-0.2.0.tar.gz |
|---|---|
| Size | 9.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ce3639f384bce79f3b30f3740960121f47a337b2826001c96ccdeb28e36ab2e7
|
|
BLAKE2b-256 checksum How to use checksums |
f6440bbb6fb2f00f090d5bbd21a6112b5533c5310080fbfe0b6d2c03dd228320
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.7
|
Release files / agentic_terminal_station-0.2.0-py3-none-any.whl
| Download URL | agentic_terminal_station-0.2.0-py3-none-any.whl |
|---|---|
| Size | 8.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
18c9fc45f88bfea43959bf8ce777b42b01f74d6c0021cc7d8797da4415bc3c18
|
|
BLAKE2b-256 checksum How to use checksums |
91ed3b118ff48755ab93ff1119bea11de2e336508ef3968d11f8a1b1a914ca03
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.7
|
Security for agentic-terminal-station 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
