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
   

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