Local Development MCP Server

A local MCP server for Claude Desktop with persistent task management, file operations, document generation, and PDF indexing.

What's New in v2.0.0

• SQLite persistence for tasks — tasks now survive server restarts and recompiles

• Zero native dependencies — uses sql.js (SQLite as WebAssembly), installs on Windows/macOS/Linux without build tools

• Two new task tools — delete-task and search-tasks

• Weekly review tool — tasks-completed-this-week for standups

Related MCP server: vulcan-file-ops

Prerequisites

• Node.js 18+

• npm

• Claude Desktop

Quick Start

1. Clone and install

git clone <your-repo-url>
cd mcp-server
npm install

No build tools required — sql.js is pure WebAssembly.

2. Build and run

npm run build
npm start

Expected output:

Task database created at: C:\Users\<you>\mcp-tasks.db
MCP Server v2.0.0 running on stdio
Task database: C:\Users\<you>\mcp-tasks.db

3. Connect Claude Desktop

Edit your Claude config:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "local-dev": {
      "command": "node",
      "args": ["C:\\Projects\\mcp-server\\dist\\index.js"]
    }
  }
}

Restart Claude Desktop after saving.

Development Workflow

Local development (auto-restart)

npm run watch

Claude Desktop workflow

npm run build
# restart Claude Desktop

Task Database

Tasks are stored in a SQLite database at:

• Windows: C:\Users\<you>\mcp-tasks.db

• macOS/Linux: ~/mcp-tasks.db

The database is created automatically on first run. The server loads it into memory on startup and saves it to disk after every write. You can open it with any SQLite viewer (e.g. DB Browser for SQLite).

How to use the task tools

Try these prompts in Claude Desktop after connecting:

Available Tools

File Operations

Task Management (SQLite — persistent)

Document Generation

PDF / Document Indexing

Available Scripts

npm run build   # Compile TypeScript to dist/
npm run dev     # Run from source once (tsx)
npm start       # Run compiled server (dist/index.js)
npm run watch   # Run from source with auto-restart

Documentation

• QUICKSTART.md — setup and first run

• TUTORIAL.md — add your own tool

• TROUBLESHOOTING.md — common fixes

• API_REFERENCE.md — technical reference

• DOCUMENTATION.md — architecture overview