RG-agentic_terminal 0.1.0__tar.gz

rg_agentic_terminal-0.1.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: RG-agentic_terminal
+Version: 0.1.0
+Summary: An MCP which adds the terminal capabilities to an agent.
+Author-email: Rohan <rohangorde0505@gmail.com>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=4.2.0

rg_agentic_terminal-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "RG-agentic_terminal"
+version = "0.1.0"
+description = "An MCP which adds the terminal capabilities to an agent."
+readme = "README.md"
+authors = [
+    { name = "Rohan", email = "rohangorde0505@gmail.com" }
+]
+requires-python = ">=3.13"
+dependencies = [
+    "fastmcp>=4.2.0",
+]
+
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tools.setuptools.packages.find]
+where = ["src"]
+
+[project.scripts]
+agentic_terminal = "agentic_terminal.main:main"

rg_agentic_terminal-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

rg_agentic_terminal-0.1.0/src/RG_agentic_terminal.egg-info/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: RG-agentic_terminal
+Version: 0.1.0
+Summary: An MCP which adds the terminal capabilities to an agent.
+Author-email: Rohan <rohangorde0505@gmail.com>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=4.2.0

rg_agentic_terminal-0.1.0/src/RG_agentic_terminal.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+src/__init__.py
+src/RG_agentic_terminal.egg-info/PKG-INFO
+src/RG_agentic_terminal.egg-info/SOURCES.txt
+src/RG_agentic_terminal.egg-info/dependency_links.txt
+src/RG_agentic_terminal.egg-info/entry_points.txt
+src/RG_agentic_terminal.egg-info/requires.txt
+src/RG_agentic_terminal.egg-info/top_level.txt
+src/agentic_terminal/__init__.py
+src/agentic_terminal/main.py
+src/agentic_terminal/tools.py

rg_agentic_terminal-0.1.0/src/RG_agentic_terminal.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

rg_agentic_terminal-0.1.0/src/RG_agentic_terminal.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agentic_terminal = agentic_terminal.main:main

rg_agentic_terminal-0.1.0/src/RG_agentic_terminal.egg-info/requires.txt

@@ -0,0 +1 @@
+fastmcp>=4.2.0

rg_agentic_terminal-0.1.0/src/RG_agentic_terminal.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+__init__
+agentic_terminal

rg_agentic_terminal-0.1.0/src/agentic_terminal/main.py

@@ -0,0 +1,7 @@
+from agentic_terminal.tools import mcp 
+
+def main():
+    mcp.run(transport="stdio")
+
+if __name__ == "__main__":
+    main()

rg_agentic_terminal-0.1.0/src/agentic_terminal/tools.py

@@ -0,0 +1,460 @@
+
+from fastmcp import FastMCP
+
+import os
+import sys
+import shutil
+import subprocess
+import platform
+import hashlib
+import json
+from pathlib import Path
+from datetime import datetime
+
+mcp = FastMCP()
+
+
+# ============================================================
+# 1. ORIGINAL TOOLS - PRESERVED
+# ============================================================
+
+@mcp.tool()
+def bash(command: str):
+    '''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.'''
+    import subprocess
+    try:
+        result = subprocess.run(command, shell=True, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        return result.stdout.decode('utf-8')
+    except subprocess.CalledProcessError as e:
+        return e.stderr.decode('utf-8')
+
+
+@mcp.tool()
+def python_code(code: str):
+    '''This function will execute a python code and return the output.'''
+    import subprocess
+    try:
+        result = subprocess.run(['python', '-c', code], check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        return result.stdout.decode('utf-8')
+    except subprocess.CalledProcessError as e:
+        return e.stderr.decode('utf-8')
+
+
+@mcp.tool()
+def python_file(file: str):
+    '''This function will execute a python file and return the output.'''
+    import subprocess
+    try:
+        result = subprocess.run(['python', file], check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        return result.stdout.decode('utf-8')
+    except subprocess.CalledProcessError as e:
+        return e.stderr.decode('utf-8')
+
+
+@mcp.tool()
+def glob(pattern: str):
+    '''This function will return a list of files that match the given pattern. This function is useful for finding files in a directory.'''
+    import glob
+    return glob.glob(pattern)
+
+
+@mcp.tool()
+def grep(pattern: str, file: str):
+    '''This function will search for the given pattern in the specified file and return the matching lines.'''
+    import subprocess
+
+    result = subprocess.run(
+        ['findstr', pattern, file],
+        stdout=subprocess.PIPE,
+        text=True
+    )
+
+    print(result.stdout)
+
+
+@mcp.tool()
+def read_file(file: str):
+    '''This function will read the contents of a file and return it as a string.'''
+    try:
+        with open(file, 'r') as f:
+            return f.read()
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def write_file(file: str, content: str):
+    '''This function will write the given content to a file. If the file does not exist, it will be created.'''
+    try:
+        with open(file, 'w') as f:
+            f.write(content)
+        return f"Content written to {file} successfully."
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def create_folder(folder: str):
+    '''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.'''
+    import os
+    try:
+        os.makedirs(folder)
+        return f"Folder '{folder}' created successfully."
+    except FileExistsError:
+        return f"Folder '{folder}' already exists."
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def delete_folder(folder: str):
+    '''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.'''
+    import shutil
+    import os
+    try:
+        if os.path.exists(folder):
+            shutil.rmtree(folder)
+            return f"Folder '{folder}' deleted successfully."
+        else:
+            return f"Folder '{folder}' does not exist."
+    except Exception as e:
+        return str(e)
+
+
+# ============================================================
+# 2. DIRECTORY MANAGEMENT TOOLS
+# ============================================================
+
+@mcp.tool()
+def list_directory(directory: str = "."):
+    '''List all files and folders inside a directory with their types.'''
+    try:
+        path = Path(directory)
+
+        if not path.exists():
+            return f"Directory '{directory}' does not exist."
+
+        if not path.is_dir():
+            return f"'{directory}' is not a directory."
+
+        items = []
+
+        for item in sorted(path.iterdir()):
+            item_type = "Directory" if item.is_dir() else "File"
+            items.append({
+                "name": item.name,
+                "type": item_type,
+                "path": str(item.resolve())
+            })
+
+        return json.dumps(items, indent=4)
+
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def directory_tree(directory: str = ".", max_depth: int = 3):
+    '''Generate a visual tree structure of directories and files.'''
+    try:
+        root = Path(directory)
+
+        if not root.is_dir():
+            return "Invalid directory."
+
+        lines = [root.name]
+
+        def build_tree(path, prefix="", depth=0):
+            if depth >= max_depth:
+                return
+
+            try:
+                entries = sorted(
+                    path.iterdir(),
+                    key=lambda p: (p.is_file(), p.name.lower())
+                )
+            except PermissionError:
+                lines.append(prefix + "[Permission denied]")
+                return
+
+            for index, entry in enumerate(entries):
+                last = index == len(entries) - 1
+                connector = "└── " if last else "├── "
+
+                lines.append(prefix + connector + entry.name)
+
+                if entry.is_dir():
+                    extension = "    " if last else "│   "
+                    build_tree(entry, prefix + extension, depth + 1)
+
+        build_tree(root)
+
+        return "\n".join(lines)
+
+    except Exception as e:
+        return str(e)
+
+
+# ============================================================
+# 3. ADVANCED FILE MANAGEMENT
+# ============================================================
+
+@mcp.tool()
+def append_file(file: str, content: str):
+    '''Append new content to an existing file or create a new file.'''
+    try:
+        with open(file, "a", encoding="utf-8") as f:
+            f.write(content)
+
+        return f"Content appended successfully to {file}."
+
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def copy_file(source: str, destination: str):
+    '''Copy a file from source to destination.'''
+    try:
+        if not os.path.isfile(source):
+            return "Source file does not exist."
+
+        shutil.copy2(source, destination)
+
+        return f"File copied from {source} to {destination}."
+
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def move_file(source: str, destination: str):
+    '''Move a file from one location to another.'''
+    try:
+        if not os.path.exists(source):
+            return "Source does not exist."
+
+        shutil.move(source, destination)
+
+        return f"Moved {source} to {destination}."
+
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def rename_file(file: str, new_name: str):
+    '''Rename a file or directory.'''
+    try:
+        path = Path(file)
+
+        if not path.exists():
+            return "File or directory does not exist."
+
+        new_path = path.with_name(new_name)
+        path.rename(new_path)
+
+        return f"Renamed successfully to {new_path}."
+
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def file_info(file: str):
+    '''Get detailed information about a file including size, extension and timestamps.'''
+    try:
+        path = Path(file)
+
+        if not path.exists():
+            return "File does not exist."
+
+        stats = path.stat()
+
+        information = {
+            "name": path.name,
+            "absolute_path": str(path.resolve()),
+            "extension": path.suffix,
+            "size_bytes": stats.st_size,
+            "size_kb": round(stats.st_size / 1024, 2),
+            "created_time": datetime.fromtimestamp(stats.st_ctime).isoformat(),
+            "modified_time": datetime.fromtimestamp(stats.st_mtime).isoformat(),
+            "is_file": path.is_file(),
+            "is_directory": path.is_dir()
+        }
+
+        return json.dumps(information, indent=4)
+
+    except Exception as e:
+        return str(e)
+
+
+# ============================================================
+# 4. CODE INTELLIGENCE TOOLS
+# ============================================================
+
+@mcp.tool()
+def search_files(directory: str, pattern: str, file_extension: str = "*"):
+    '''Search for text inside files recursively.
+    Supports filtering by file extension, for example .py or .js.
+    '''
+    try:
+        root = Path(directory)
+
+        if not root.is_dir():
+            return "Invalid directory."
+
+        results = []
+
+        for file in root.rglob("*"):
+            if not file.is_file():
+                continue
+
+            if file_extension != "*" and file.suffix.lower() != file_extension.lower():
+                continue
+
+            try:
+                with file.open("r", encoding="utf-8") as f:
+                    for line_number, line in enumerate(f, start=1):
+                        if pattern.lower() in line.lower():
+                            results.append({
+                                "file": str(file),
+                                "line": line_number,
+                                "content": line.strip()
+                            })
+
+            except (UnicodeDecodeError, PermissionError, OSError):
+                continue
+
+        return json.dumps(results, indent=4)
+
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def count_lines(file: str):
+    '''Count total lines, non-empty lines and characters in a source-code file.'''
+    try:
+        path = Path(file)
+
+        if not path.is_file():
+            return "File does not exist."
+
+        with path.open("r", encoding="utf-8") as f:
+            content = f.read()
+
+        lines = content.splitlines()
+
+        result = {
+            "file": str(path),
+            "total_lines": len(lines),
+            "non_empty_lines": sum(1 for line in lines if line.strip()),
+            "characters": len(content),
+            "words": len(content.split())
+        }
+
+        return json.dumps(result, indent=4)
+
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def file_hash(file: str):
+    '''Calculate SHA-256 hash of a file for integrity verification.'''
+    try:
+        path = Path(file)
+
+        if not path.is_file():
+            return "File does not exist."
+
+        sha256 = hashlib.sha256()
+
+        with path.open("rb") as f:
+            for chunk in iter(lambda: f.read(1024 * 1024), b""):
+                sha256.update(chunk)
+
+        return {
+            "file": str(path),
+            "algorithm": "SHA-256",
+            "hash": sha256.hexdigest()
+        }
+
+    except Exception as e:
+        return str(e)
+
+
+# ============================================================
+# 5. SYSTEM INFORMATION TOOLS
+# ============================================================
+
+@mcp.tool()
+def system_info():
+    '''Get operating system, architecture, Python version and machine information.'''
+    try:
+        information = {
+            "operating_system": platform.system(),
+            "os_release": platform.release(),
+            "os_version": platform.version(),
+            "architecture": platform.machine(),
+            "processor": platform.processor(),
+            "hostname": platform.node(),
+            "python_version": sys.version,
+            "python_executable": sys.executable,
+            "current_directory": os.getcwd()
+        }
+
+        return json.dumps(information, indent=4)
+
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def disk_usage(path: str = "."):
+    '''Check total, used and available disk space for a given path.'''
+    try:
+        total, used, free = shutil.disk_usage(path)
+
+        information = {
+            "path": str(Path(path).resolve()),
+            "total_gb": round(total / (1024 ** 3), 2),
+            "used_gb": round(used / (1024 ** 3), 2),
+            "free_gb": round(free / (1024 ** 3), 2),
+            "usage_percent": round((used / total) * 100, 2)
+        }
+
+        return json.dumps(information, indent=4)
+
+    except Exception as e:
+        return str(e)
+
+
+@mcp.tool()
+def installed_packages():
+    '''List all Python packages installed in the active Python environment.'''
+    try:
+        result = subprocess.run(
+            [sys.executable, "-m", "pip", "list", "--format=json"],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+
+        return result.stdout
+
+    except subprocess.CalledProcessError as e:
+        return e.stderr
+
+    except Exception as e:
+        return str(e)
+
+
+# ============================================================
+# 6. SERVER ENTRY POINT
+# ============================================================
+
+if __name__ == "__main__":
+    mcp.run()