feat: Add task-mcp server for task management via MCP
Implements 10 MCP tools for task management: - CRUD: task_add, task_list, task_show, task_close, task_update - Search: task_similar (pgvector), task_context - Relations: task_link, task_checklist_add, task_checklist_toggle Uses PostgreSQL with pgvector for semantic search via LiteLLM embeddings. Connects via SSH tunnel to docker-host:5435. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
58
README.md
Normal file
58
README.md
Normal file
@@ -0,0 +1,58 @@
|
||||
# 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)
|
||||
```
|
||||
Reference in New Issue
Block a user