# Agentic MCP Server

This **Agentic MCP Server** acts as the "Hands and Eyes" for an Autonomous AI Agent, bridging the gap between Large Language Models and your local development environment. It enables "Spec-Driven Development" by providing safe, controlled access for file manipulation, context reading, command execution, and documentation verification.

## 🛠️ Tools Reference

The server currently exposes **4 active tools** designed with strict safety mechanisms to ensure secure operation.

| Tool Name | Description | Input Parameters | Safety Mechanisms |
| :--- | :--- | :--- | :--- |
| **`atomic-writer`** | Writes file content with automatic backup creation. | `path` (string)<br>`content` (string) | • **Path Traversal Protection**: Writes only within project root.<br>• **Backups**: Creates `.bak` files before overwriting.<br>• **Blocked Files**: Prevents overwriting critical config (e.g., `mcp_manifest.json`). |
| **`fs-reader`** | Reads files relative to the project root. | `path` (string) | • **Sandboxed**: Access restricted to project root.<br>• **Size Limit**: Max 5MB per file to prevent context overflow. |
| **`terminal-runner`** | Executes specific shell commands. | `command` (enum: `npm`, `node`, `tsc`)<br>`args` (string[])<br>`timeoutMs` (number) | • **Allowlist**: Only runs `npm`, `node`, and `tsc`.<br>• **Timeout**: Enforced execution limits (default 30s).<br>• **Input Sanitization**: Prevents command injection. |
| **`doc-fetcher`** | Fetches and converts documentation to Markdown. | `url` (string)<br>`timeoutMs` (number)<br>`maxBytes` (number) | • **Host Allowlist**: Restricted to trusted domains (`github.com`, `gitlab.com`, `developer.mozilla.org`).<br>• **Size Cap**: Max 1.5MB download limit. |

## 🚀 Installation & Setup

### Prerequisites
- **Node.js** (v18 or higher recommended)
- **npm**

### Setup Steps

1.  **Clone and Install Dependencies**:
    ```bash
    npm install
    ```

2.  **Build the Server**:
    ```bash
    npm run build
    ```
    This compiles the TypeScript source into the `dist/` directory.

## 🔌 Client Configuration

To use this server with an MCP-compatible client (like Claude Desktop), add the following configuration to your settings file (e.g., `claude_desktop_config.json`).

```json
{
  "mcpServers": {
    "agentic-server": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/mcp-agentic-jvl/dist/index.js"
      ]
    }
  }
}
```
*Note: Replace `/ABSOLUTE/PATH/TO/...` with the actual full path to your project directory.*

## 🚧 Roadmap / Coming Soon

The following features are currently in development:

*   **PostgreSQL Introspection (`sql_db_inspector`)**: A tool to safely inspect database schemas and table structures to assist with database-related tasks.