# Vighnesh Agentic Terminal MCP Server 🚀

A powerful, production-ready **Model Context Protocol (MCP)** server built using `FastMCP`. This package exposes a secure terminal automation and complete file management suite directly to any AI agent (like Claude Desktop, Cursor, or custom LangChain applications).

---

## 🛠️ Tools Included

Once connected, your AI agent automatically inherits **9 advanced utility tools**:

* `bash`: Executes any local system terminal command and streams back text responses.
* `python_code`: Runs raw inline Python script snippets inside an isolated process execution window.
* `python_file`: Executes a target `.py` file from disk and captures execution outputs.
* `glob`: Performs directory file discovery matching patterns (e.g., `*.json`).
* `grep`: Searches for text patterns across flat documents natively on Windows (`findstr`).
* `read_file`: Reads text data from target disk structures safely into LLM context memory.
* `write_file`: Dynamically creates or updates workspace layout data files.
* `create_folder`: Automates file structural setups with safe existence confirmations.
* `delete_folder`: Recursively flushes target directories and garbage code components.

---

## 💾 Installation & Usage

Because this package is published on the global **PyPI** registry, users do not need to download or clone your source repositories manually. 

### 1. The Direct `uvx` Way (Recommended)
You can call, stream, and initialize the server on-demand using the `uvx` package launcher. Add this directly to your AI client's initialization configuration dictionary:

#### 🐍 Python Client Configuration (`lagchain-mcp_client.py`)
```python
client = MultiServerMCPClient({
    "vighnesh_agentic_terminal": {
        "transport": "stdio",
        "command": "uvx",
        "args": ["vighnesh-agentic-terminal-mcp"]
    }
})
```

#### 💬 Claude Desktop App Configuration (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "vighnesh-agentic-terminal": {
      "command": "uvx",
      "args": ["vighnesh-agentic-terminal-mcp"]
    }
  }
}
```

---

### 2. The Local Pre-Installed Way
If you prefer to install the utility shortcut command execution hook globally onto your host system operating profile:

```bash
uv tool install vighnesh-agentic-terminal-mcp
```

Once installed globally, you can test or call the server using its shortcut command hook parameters without wrapping it in a package manager array string:

```json
{
  "mcpServers": {
    "vighnesh-agentic-terminal": {
      "command": "vighnesh-agentic-terminal-mcp",
      "args": []
    }
  }
}
```

---

## 🧑‍💻 Development & Local Builds

To modify code or re-package distribution wheels locally inside your active workspace directories:

```bash
# 1. Compile updated wheels
uv build

# 2. Reinstall local builds natively into active virtual profiles
uv pip install file.whl 
```