afe2f8bc0b
- Add session_memories table for persistent learnings - Add memory_add, memory_search, memory_list, memory_context tools - Supports semantic search via embeddings - Categories: pattern, fix, preference, gotcha, architecture Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
60 lines
1.6 KiB
Markdown
60 lines
1.6 KiB
Markdown
# 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 5432:localhost:5432 docker-host -N &`
|
|
- PostgreSQL with pgvector on docker-host (CI stack `postgres` container)
|
|
- CI postgres must be running: `ssh docker-host "cd /opt/docker/ci && docker compose up -d postgres"`
|
|
|
|
## Configuration
|
|
|
|
Add to `~/.claude/settings.json` under `mcpServers`:
|
|
|
|
```json
|
|
{
|
|
"task-mcp": {
|
|
"command": "node",
|
|
"args": ["/path/to/task-mcp/dist/index.js"],
|
|
"env": {
|
|
"DB_HOST": "localhost",
|
|
"DB_PORT": "5432",
|
|
"DB_NAME": "agiliton",
|
|
"DB_USER": "agiliton",
|
|
"DB_PASSWORD": "<from /opt/docker/ci/.env>",
|
|
"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)
|
|
```
|