Task Manager (@abyssbug/task-manager)

A small Model Context Protocol (MCP) server that manages a simple tasks.json file.

Quick Start

Run with Bun (recommended):

bunx @abyssbug/task-manager --tasks-file ~/Documents/tasks.json

Or set the path via env (defaults to ~/Documents/tasks.json if omitted):

TASK_MANAGER_FILE_PATH=/Users/you/Documents/tasks.json bunx @abyssbug/task-manager

Using npx is acceptable if Bun is installed (the binary uses a Bun shebang):

npx -y @abyssbug/task-manager --tasks-file ~/Documents/tasks.json

MCP Config Examples

For generic MCP clients (~/.mcp/servers.json):

{ "mcpServers": { "task-manager": { "command": "bunx", "args": ["@abyssbug/task-manager", "--tasks-file", "/Users/you/Documents/tasks.json"] } } }

For Cursor (~/.cursor/mcp.json):

{ "task-manager": { "command": "bunx", "args": ["@abyssbug/task-manager", "--tasks-file", "/Users/you/Documents/tasks.json"], "working_directory": "/Users/you/Documents" } }

HTTP Mode (for Smithery or custom hosting)

The server can run over HTTP when MCP_TRANSPORT=http.
Endpoints:
- GET /health → { ok: true }
- GET /tools → JSON tool list
- POST /call → Body: { "name": "tool_name", "arguments": { ... } }

Run locally in HTTP mode with Bun:

MCP_TRANSPORT=http PORT=3000 bun run dev # then in another terminal curl http://localhost:3000/health curl http://localhost:3000/tools curl -X POST http://localhost:3000/call -H 'content-type: application/json' -d '{"name":"list_requests","arguments":{}}'