Uten Agent Terminal MCP

An MCP server that gives an AI agent terminal-style capabilities through FastMCP. It exposes tools for running shell commands, executing Python code, reading and writing files, searching text, and creating or deleting folders.

Features

• Run shell commands through the bash tool.
• Execute inline Python code.
• Execute Python files.
• Find files with glob patterns.
• Search file content with findstr.
• Read and write files.
• Create and delete folders.
• Run over MCP stdio, which makes it suitable for local MCP clients.

Requirements

• Python 3.12 or newer
• fastmcp

The project currently uses Python 3.14 locally, as defined in .python-version.

Installation

Clone the project and install the package in editable mode:

git clone <your-repository-url>
cd MCP_PYPI
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .

If you use uv, you can install the locked dependencies with:

uv sync

Usage

Start the MCP server:

uten_agentic_terminal_mcp

The server runs with stdio transport, so it is intended to be launched by an MCP-compatible client.

After installation, you can also run the module directly:

python -m agentic_terminal.main

Available Tools

Project Structure

MCP_PYPI/
+-- src/
|   +-- agentic_terminal/
|       +-- __init__.py
|       +-- main.py
|       +-- tools.py
+-- dist/
+-- pyproject.toml
+-- uv.lock
+-- README.md

Build

To build the package:

python -m build

The generated wheel and source distribution will be placed in dist/.

Publish

After building, publish with Twine:

twine upload dist/*

For TestPyPI:

twine upload --repository testpypi dist/*

Security Notice

This MCP server exposes powerful local system tools. It can run shell commands, execute Python code, write files, and delete folders. Only use it with MCP clients and agents that you trust, and avoid running it with unnecessary system privileges.

License

Add a license before publishing this package publicly.