# 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":{}}'
```