Skip to main content
Glama
Sign In
Agentic MCP Server

Agentic MCP Server

by lucastl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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)content (string)

• Path Traversal Protection: Writes only within project root.• Backups: Creates .bak files before overwriting.• 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.• Size Limit: Max 5MB per file to prevent context overflow.

terminal-runner

Executes specific shell commands.

command (enum: npm, node, tsc)args (string[])timeoutMs (number)

• Allowlist: Only runs npm, node, and tsc.• Timeout: Enforced execution limits (default 30s).• Input Sanitization: Prevents command injection.

doc-fetcher

Fetches and converts documentation to Markdown.

url (string)timeoutMs (number)maxBytes (number)

• Host Allowlist: Restricted to trusted domains (github.com, gitlab.com, developer.mozilla.org).• Size Cap: Max 1.5MB download limit.

Related MCP server: Softority MCP Server

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

Available Tools

9 tools
atomic-writerB

Writes file content with automatic backup creation and path safety validation.

Inputs: path (required), content (required). Returns: path, bytesWritten, backupCreated

code-searchA

Performs regex or text searches over project files, excluding node_modules and .git.

Inputs: query (required), regex, maxResults, pathFilter, +1 more. Returns: query, regex, results, truncated, +1 more

doc-fetcherA

Fetches allow-listed documentation URLs and returns Markdown-formatted content.

Inputs: url (required), maxBytes, timeoutMs. Returns: url, bytes, status, markdown, +2 more

fs-readerA

Reads files relative to the project root with a 5MB size cap.

Inputs: path (required). Returns: data, path, size, encoding

git-observerA

Provides read-only git status, log, and diff information.

Inputs: command (required), ref, path, limit, +1 more. Returns: log, diff, status, command

pingA

Responds with a pong acknowledgement and timestamp to verify connectivity.

Inputs: message. Returns: ok, response, receivedAt

plan-managerA

Lists, reads, and writes .plan.json files under docs/archive.

Inputs: action (required), data, file. Returns: file, plan, files, action

project-topologyA

Produces a directory tree snapshot rooted at the project base, excluding ignored directories.

Inputs: path, maxDepth. Returns: root, ignored, truncated

terminal-runnerA

Executes allow-listed shell commands (npm, node, tsc) with enforced timeout and captured output.

Inputs: command (required), args, timeoutMs. Returns: args, signal, stderr, stdout, +6 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A3.9/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool targets a distinct concern: connectivity, file reading, planning, search, git inspection, writing, command execution, project structure, and documentation fetching. There is no meaningful overlap that would cause an agent to select the wrong tool.

    Naming Consistency4/5

    Most names follow a consistent lowercase hyphenated compound pattern like fs-reader, git-observer, and terminal-runner. The lone ping is a minor deviation, but overall the style is predictable and readable.

    Tool Count5/5

    Nine tools is well-scoped for an agentic coding assistance server. Each tool earns its place and the set is neither bloated nor too thin.

    Completeness4/5

    The tool set covers the core agent loop: reading, writing, searching, executing, inspecting git state, planning, and fetching docs. Minor gaps like file deletion/rename and git write operations are present, but they are not critical for many workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers