README.md•1.63 kB
# 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":{}}'
```