Skip to main content
Glama
local-mcp-server

local-mcp-server

by iKennas

local-mcp-server

A stdio MCP server that exposes local file I/O, a small shell whitelist, and SQLite helpers. Built for wiring Cursor/Claude Desktop to stuff on your machine without giving the model full shell access.

Setup

npm install
npm run build
cp config.example.json config.json
# edit allowedRoots to match your machine

Add to your MCP client config (Cursor example):

{
  "mcpServers": {
    "local": {
      "command": "node",
      "args": ["D:/path/to/local-mcp-server/dist/index.js"],
      "env": {
        "LOCAL_MCP_CONFIG": "D:/path/to/local-mcp-server/config.json"
      }
    }
  }
}

Related MCP server: local-os-brain

Tools

Tool

What it does

read_file / list_dir / write_file

Scoped to allowedRoots in config

system_info

Host stats, no secrets

run_command

Whitelist only: echo, date, pwd, whoami, uname

db_query / db_exec

SQLite via named aliases in config

Limitations

  • File access is path-jail'd but still powerful — don't point allowedRoots at $HOME.

  • Shell tool is intentionally useless for real admin work.

  • db_exec blocks DROP/ALTER; everything else is on you.

  • Windows: uname won't work unless you have it installed.

Dev

npm run dev      # tsx, stdio — hard to debug interactively
npm test

MIT licensed. PRs welcome for additional read-only system probes.

Available Tools

7 tools
db_execC

Run a mutating SQL statement (INSERT/UPDATE/DELETE)

Inputs: alias (required), sql (required), params.

db_queryA

Run a read-only SQL query against a configured SQLite database

Inputs: alias (required), sql (required), params.

list_dirB

List entries in a directory

Inputs: path.

read_fileC

Read a text file from an allowed directory

Inputs: path (required).

run_commandC

Run a whitelisted shell command (no pipes)

Inputs: command (required), args.

system_infoA

Return basic host information

Inputs: no named parameters.

write_fileC

Write text to a file (creates parent dirs)

Inputs: path (required), content (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: database operations separate read and write, file operations are split into listing, reading, and writing, and shell commands are distinct from system info. No overlapping responsibilities.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., db_query, list_dir, run_command), making the set predictable and easy to navigate.

    Tool Count5/5

    With 7 tools, the server covers a broad range of basic local operations (database, file system, shell) without being bloated or insufficient. The scope is well-matched to a general-purpose utility server.

    Completeness4/5

    The tool surface covers essential CRUD-like operations for databases and files, plus command execution and system info. Minor gaps exist, like no explicit file deletion or directory creation, but write_file creates parent directories and the set is functional for common tasks.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Exposes a governed, OAuth-gated suite of 38 tools that let web AI assistants like Claude, ChatGPT, and Grok work directly on your local machine — reading and editing files, running whitelisted shell commands, searching, querying SQLite, driving browsers and DevTools, managing background tasks and localhost services, and controlling Git, clipboard, notifications, and Postman. This lets users build, debug, and maintain projects, inspect databases and local APIs, and check on long-running jobs from a browser or phone without granting unrestricted shell access.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes a governed, OAuth-gated set of tools that let web-based AI chat clients read and write local files, run whitelisted shell commands, search code, inspect Git and SQLite data, automate browsers and DevTools, and manage background jobs, localhost services, clipboard, notifications, and Postman on the user's own machine.
      MIT