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: MCP Server Toolkit

Tools

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.