# Task MCP Server

Exposes task management tools via Model Context Protocol. Uses PostgreSQL with pgvector for semantic search.

## Requirements

- SSH tunnel to docker-host: `ssh -L 5435:localhost:5435 docker-host -N &`
- PostgreSQL with pgvector on docker-host (litellm-pgvector container)

## Configuration

Add to `~/.claude/mcp_servers.json`:

```json
{
  "task-mcp": {
    "command": "node",
    "args": ["/path/to/task-mcp/dist/index.js"],
    "env": {
      "DB_HOST": "localhost",
      "DB_PORT": "5435",
      "DB_NAME": "litellm",
      "DB_USER": "litellm",
      "DB_PASSWORD": "litellm",
      "LLM_API_URL": "https://llm.agiliton.cloud",
      "LLM_API_KEY": "sk-master-..."
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `task_add` | Create task with auto-generated ID and embedding |
| `task_list` | List tasks with filters (project, status, type, priority) |
| `task_show` | Show task details including checklist and dependencies |
| `task_close` | Mark task as completed |
| `task_update` | Update task fields |
| `task_similar` | Find semantically similar tasks using pgvector |
| `task_context` | Get related tasks for current work context |
| `task_link` | Create dependency between tasks |
| `task_checklist_add` | Add checklist item to task |
| `task_checklist_toggle` | Toggle checklist item |

## Build

```bash
npm install
npm run build
```

## Development

```bash
npm run dev  # Run with tsx (no build)
```