knktx 0.1.0__tar.gz

knktx-0.1.0/.gitignore

@@ -0,0 +1,41 @@
+# Environment
+.env
+.env.*
+!.env.example
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+
+# Node
+node_modules/
+web/dist/
+
+# Docker
+postgres_data/
+
+# Backups
+backups/
+.env.backup
+!.env.backup.example
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Reviews (generated by PR review agents)
+docs/reviews/
+
+# Playground files
+*-playground.html
+*-explorer.html
+
+# uv
+.python-version

knktx-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: knktx
+Version: 0.1.0
+Summary: MCP server for knktx — AI agent project management
+Requires-Python: >=3.11
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: mcp<2,>=1.12

knktx-0.1.0/README.md

@@ -0,0 +1,150 @@
+# knktx-mcp
+
+MCP server for [knktx](https://github.com/StanK23/knktx) — AI agent project management.
+
+Provides project, board, card, document, memory, skill, and config management tools via the Model Context Protocol.
+
+## Installation
+
+```bash
+pip install .
+# or with uv:
+uv pip install .
+```
+
+## Configuration
+
+Set these environment variables:
+
+```bash
+export KNKTX_API_URL="https://your-instance.com/api/v1"
+export KNKTX_API_KEY="your-api-key"
+```
+
+Generate an API key from the knktx Settings page.
+
+## Usage
+
+### With Claude Code
+
+Add to your `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "knktx": {
+      "command": "knktx-mcp",
+      "env": {
+        "KNKTX_API_URL": "https://your-instance.com/api/v1",
+        "KNKTX_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Standalone
+
+```bash
+knktx-mcp
+```
+
+The server uses stdio transport by default.
+
+## Available Tools
+
+### Projects
+| Tool | Description |
+|------|-------------|
+| `list_projects` | List all projects |
+| `create_project` | Create a new project |
+| `get_project` | Get project details |
+| `update_project` | Update project fields |
+| `archive_project` | Archive a project |
+| `restore_project` | Restore archived project |
+| `delete_project` | Delete a project |
+
+### Boards & Cards
+| Tool | Description |
+|------|-------------|
+| `list_boards` | List boards in a project |
+| `create_board` | Create a plan board |
+| `get_board` | Get board with cards |
+| `update_board` | Update board fields |
+| `delete_board` | Delete a board |
+| `list_cards` | List cards on a board |
+| `get_card` | Get card details |
+| `create_card` | Create a task card |
+| `update_card` | Update card details |
+| `move_card` | Transition card status |
+| `reorder_card` | Reorder card position |
+| `delete_card` | Delete a card |
+| `comment_on_card` | Add comment to card |
+| `list_comments` | List card comments |
+| `update_comment` | Edit a comment |
+| `delete_comment` | Delete a comment |
+
+### Documents
+| Tool | Description |
+|------|-------------|
+| `list_documents` | List documents in a project |
+| `get_document` | Read document by type |
+| `get_document_by_id` | Read document by ID |
+| `create_document` | Create a document |
+| `update_document` | Update document content |
+| `delete_document` | Delete a document |
+
+### Notes
+| Tool | Description |
+|------|-------------|
+| `list_notes` | List notes with optional status filter |
+| `search_notes` | Search notes by keyword |
+| `write_note` | Create or update a note |
+| `delete_note` | Delete a note |
+
+### Skills & Plugins
+| Tool | Description |
+|------|-------------|
+| `list_skills` | List available skills |
+| `get_skill` | Get skill content |
+| `create_skill` | Create a skill |
+| `update_skill` | Update a skill |
+| `delete_skill` | Delete a skill |
+| `list_plugins` | List agent plugins |
+| `get_plugin` | Get plugin details |
+| `create_plugin` | Create a plugin |
+| `update_plugin` | Update a plugin |
+| `delete_plugin` | Delete a plugin |
+
+### MCP Configs
+| Tool | Description |
+|------|-------------|
+| `list_mcp_configs` | List MCP server configs |
+| `get_mcp_config` | Get MCP server config |
+| `create_mcp_config` | Create MCP config |
+| `update_mcp_config` | Update MCP config |
+| `delete_mcp_config` | Delete MCP config |
+
+### Rules & Workflows
+| Tool | Description |
+|------|-------------|
+| `get_workflows` | Get rules + workflows (bootstrap) |
+| `list_workflows` | List workflow definitions |
+| `get_workflow` | Get workflow details |
+| `create_workflow` | Create a workflow |
+| `update_workflow` | Update a workflow |
+| `delete_workflow` | Delete a workflow |
+| `duplicate_workflow` | Duplicate a workflow |
+| `list_rules` | List rules |
+| `get_rule` | Get rule details |
+| `create_rule` | Create a rule |
+| `update_rule` | Update a rule |
+| `delete_rule` | Delete a rule |
+| `check_obligations` | Check pending obligations |
+| `start_workflow` | Start a workflow |
+| `get_current_step` | Get current workflow step |
+
+### Activity
+| Tool | Description |
+|------|-------------|
+| `get_activity` | Get project activity log |

knktx-0.1.0/knktx_mcp/__init__.py

@@ -0,0 +1 @@
+"""knktx MCP server — pip-installable MCP server for AI agents."""