MCP 服务器

Local Development MCP Server

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

README

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

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:

What you want	What to say to Claude
Add a task	"Create a task: review the API docs, high priority"
See all tasks	"List all my tasks"
Filter by status	"Show me all in-progress tasks"
Move a task forward	"Mark task-1 as done"
Find a task	"Search tasks for 'authentication'"
Weekly review	"What tasks did I complete this week?"
Clean up	"Delete task-3"

Available Tools

File Operations

Tool	Description
`read-file`	Read any file from disk
`write-file`	Write/create a file
`list-directory`	List folder contents

Task Management (SQLite — persistent)

Tool	Description
`create-task`	Create a task (saved to DB immediately)
`list-tasks`	List tasks, filterable by status
`update-task-status`	Move task to todo / in-progress / done
`delete-task`	Permanently delete a task
`search-tasks`	Search tasks by keyword
`tasks-completed-this-week`	Show tasks done in the last 7 days

Document Generation

Tool	Description
`generate-markdown-doc`	Generate a structured `.md` file
`generate-readme`	Scaffold a `README.md` template

PDF / Document Indexing

Tool	Description
`read-pdf`	Extract text from a PDF
`index-documents`	Bulk-index PDFs in a folder
`search-documents`	Keyword search across indexed PDFs
`list-indexes`	Show all active indexes

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