Agentic MCP Server

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:

    npm install

1. Build the Server:

    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).

{
  "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.