Skip to main content
Glama
Sign In
Uten Agent Terminal MCP

Uten Agent Terminal MCP

by dev-vieester
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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.

Related MCP server: Atlas MCP Server

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

Tool

Description

bash(command)

Runs a shell command and returns stdout or stderr.

python_code(code)

Runs inline Python code and returns stdout or stderr.

python_file(file)

Runs a Python file and returns stdout or stderr.

glob(pattern)

Returns files matching a glob pattern.

grep(pattern, file)

Searches a file using Windows findstr.

read_file(file)

Reads a file and returns its contents.

write_file(file, content)

Writes content to a file.

create_folder(folder)

Creates a folder if it does not already exist.

delete_folder(folder)

Deletes a folder recursively.

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

This project is licensed under the MIT License. See LICENSE for details.

Available Tools

9 tools
bashBashC

This function will execute a bash command and return the output. This function is useful for executing bash commands including creating files, directories, and other bash commands.

Inputs: command (required).

create_folderCreate FolderB

This function will create a folder with the given name. If the folder already exists, it will return a message indicating that the folder already exists.

Inputs: folder (required).

delete_folderDelete FolderB

This function will delete a folder with the given name. If the folder does not exist, it will return a message indicating that the folder does not exist.

Inputs: folder (required).

globGlobC

This function will return a list of files that match the given pattern. This function is useful for finding files in a directory.

Inputs: pattern (required).

grepGrepB

This function will search for the given pattern in the specified file and return the matching lines.

Inputs: file (required), pattern (required).

python_codePython CodeC

This function will execute a python code and return the output.

Inputs: code (required).

python_filePython FileC

This function will execute a python file and return the output.

Inputs: file (required).

read_fileRead FileB

This function will read the contents of a file and return it as a string.

Inputs: file (required).

write_fileWrite FileC

This function will write the given content to a file. If the file does not exist, it will be created.

Inputs: file (required), content (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.2/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have distinct file/system purposes, but bash overlaps with write_file, create_folder, delete_folder, and Python execution since it can perform arbitrary commands. Descriptions still make the primary intent of each tool separable.

    Naming Consistency3/5

    Names mix bare Unix command names (glob, grep, bash) with snake_case verb_noun patterns (read_file, write_file, create_folder). It is readable, but there is no single predictable naming convention throughout the set.

    Tool Count5/5

    9 tools is well-scoped for a terminal/filesystem agent. Core capabilities like search, read, write, and execution are covered without excessive bloat.

    Completeness4/5

    The surface covers search, read, write, folder creation/deletion, bash, and Python execution. Explicit file deletion, move, copy, and rename are missing, but bash can work around these gaps.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Atlas MCP Server

      good2idnan
      F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents and users to manage workspace files, monitor system metrics, take persistent notes, and retrieve weather data via MCP tools and resources.
      -

    • nc-tools-mcp

      ncdevshiv
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables coding agents to perform file, search, patch, git, process, test, package, network, and system operations through 60 typed MCP tools with structured inputs/outputs, structured errors, and a full event journal, replacing terminal use with a typed machine API.
      MIT