vector-task-mcp 1.0.0__tar.gz

vector_task_mcp-1.0.0/.mcp.json

@@ -0,0 +1,40 @@
+{
+    "mcpServers": {
+        "context7": {
+            "type": "stdio",
+            "command": "npx",
+            "args": [
+                "-y",
+                "@upstash/context7-mcp",
+                "--api-key",
+                "ctx7sk-d066fdcb-bd7e-4e10-acf4-522c7621e2c4"
+            ]
+        },
+        "sequential-thinking": {
+            "type": "stdio",
+            "command": "npx",
+            "args": [
+                "-y",
+                "@modelcontextprotocol/server-sequential-thinking"
+            ]
+        },
+        "vector-memory": {
+            "type": "stdio",
+            "command": "/Users/xsaven/PhpstormProjects/vector-memory-mcp/run-arm64.sh",
+            "args": [
+                "--working-dir",
+                "/Users/xsaven/PhpstormProjects/vector-task-mcp",
+                "--memory-limit",
+                "100000"
+            ]
+        },
+        "vector-task": {
+            "type": "stdio",
+            "command": "/Users/xsaven/PhpstormProjects/vector-task-mcp/run-arm64.sh",
+            "args": [
+                "--working-dir",
+                "/Users/xsaven/PhpstormProjects/vector-task-mcp"
+            ]
+        }
+    }
+}

vector_task_mcp-1.0.0/.python-version

@@ -0,0 +1 @@
+3.11

vector_task_mcp-1.0.0/CLAUDE.md

@@ -0,0 +1,118 @@
+# Vector Task MCP Server
+
+## Project Overview
+MCP (Model Context Protocol) Server для управління задачами з використанням sqlite-vec для семантичного пошуку.
+
+## Technology Stack
+- **Python**: 3.11.8 (requires >= 3.10)
+- **Package Manager**: `uv` (сучасний Python package manager)
+- **Database**: SQLite 3.43.2 + sqlite-vec extension
+- **Embeddings**: sentence-transformers/all-MiniLM-L6-v2 (384-dimensional vectors)
+- **MCP Framework**: FastMCP >= 0.3.0
+
+## Key Dependencies
+- `mcp>=0.3.0` - Model Context Protocol framework
+- `sqlite-vec>=0.1.6` - Vector search extension для SQLite
+- `sentence-transformers>=2.2.2` - Embedding models
+
+## Project Structure
+- `main.py` - Entry point with uv script configuration
+- `requirements.txt` - Python dependencies for pip/venv compatibility
+- `pyproject.toml` - Modern Python project configuration
+- `.python-version` - Python version specification (3.11)
+- `claude-desktop-config.example.json` - Claude Desktop configuration template
+- `src/models.py` - Data models and configuration
+- `src/security.py` - Security validation and sanitization
+- `src/task_store.py` - Vector task storage operations
+- `tasks.db` - SQLite database for tasks
+
+## How to Run
+
+### Standalone
+```bash
+# Using uv (requires Python with SQLite extensions support)
+uv run main.py --working-dir ./
+
+# Alternative with conda Python (has SQLite extensions support)
+~/miniconda3/envs/vector-mcp/bin/python main.py --working-dir ./
+```
+
+### Configuration Options
+
+- `--working-dir` - Working directory for task database (required, default: current directory)
+  - Specifies the project directory where the `memory/` subdirectory will be created
+  - Database will be stored at `{working-dir}/memory/tasks.db`
+  - Example: `--working-dir /path/to/project` → database at `/path/to/project/memory/tasks.db`
+
+**⚠️ IMPORTANT for macOS Users:**
+- Standard Python from python.org does NOT support SQLite loadable extensions
+- Use conda/miniforge Python or compile Python with `--enable-loadable-sqlite-extensions`
+- On Apple Silicon, ensure you're running native arm64 Python, not x86_64 through Rosetta
+
+### Claude Desktop Integration
+Використовуй `claude-desktop-config.example.json` як шаблон.
+
+Конфігурація для Claude Desktop:
+```json
+{
+  "mcpServers": {
+    "vector-task": {
+      "command": "uv",
+      "args": [
+        "run",
+        "/absolute/path/to/main.py",
+        "--working-dir",
+        "/your/project/path"
+      ]
+    }
+  }
+}
+```
+
+**ВАЖЛИВО:**
+- Використовуй абсолютні шляхи, не відносні!
+
+## Database Architecture
+- `task_metadata` - Метадані задач (title, content, status, priority, tags, timestamps)
+- `task_vectors` - Векторна таблиця (vec0 virtual table)
+- Індекси на status, priority, created_at, content_hash
+
+## Task Management Features
+- **Task Lifecycle**: pending → in_progress → completed/stopped
+- **Priorities**: low, medium, high, critical
+- **Hierarchical Tasks**: Parent-child task relationships
+- **Smart Search**: Semantic search using vector embeddings
+- **Tags**: Organize tasks with custom tags
+- **Comments**: Add notes to tasks without changing content
+
+## Available MCP Tools
+- `task_create` - Create new task
+- `task_create_bulk` - Create multiple tasks
+- `task_update` - Update task fields
+- `task_delete` / `task_delete_bulk` - Delete tasks
+- `task_list` - List/search tasks with filters
+- `task_get` - Get specific task by ID
+- `task_last` - Get last created task
+- `task_next` - Get next task to work on
+- `task_start` / `task_finish` / `task_stop` / `task_resume` - Task lifecycle
+- `task_comment` - Add/update task comments
+- `task_add_tag` / `task_remove_tag` / `task_get_all_tags` - Tag management
+- `task_stats` - Get task statistics
+
+## Important Notes
+- **sqlite-vec** працює як extension для SQLite, завантажується через `sqlite_vec.load(conn)`
+- **uv** використовується замість venv - він керує ізольованим оточенням автоматично
+- Векторний пошук використовує 384-вимірні embeddings
+- База даних: `tasks.db` (location depends on `--working-dir`, see Configuration Options)
+
+## Security Features
+- Working directory validation
+- Input sanitization
+- Content hash для дедуплікації
+- Resource limits для захисту від DoS
+- Bulk operation limits (50 creates, 100 deletes max)
+
+## Development Notes
+- Проект налаштований як uv script з inline metadata (/// script ///)
+- Не потрібно створювати venv вручну
+- Всі залежності автоматично керуються через uv

vector_task_mcp-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 cornebidouil
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vector_task_mcp-1.0.0/MANIFEST.in

@@ -0,0 +1,26 @@
+# Include documentation
+include README.md
+include LICENSE
+include CLAUDE.md
+
+# Include configuration examples
+include claude-desktop-config.example.json
+include .mcp.json
+
+# Include scripts
+include run-arm64.sh
+
+# Include requirements
+include requirements.txt
+
+# Include Python version specification
+include .python-version
+
+# Exclude unnecessary files
+exclude .gitignore
+recursive-exclude __pycache__ *
+recursive-exclude .git *
+recursive-exclude .idea *
+recursive-exclude .venv *
+recursive-exclude memory *
+exclude uv.lock