diff --git a/AGENTS.md b/AGENTS.md index 02aadf5..55275a1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,69 +2,71 @@ This document tracks the AI agents and MCP servers configured in this project. +> **Status Tracking**: Current operational status of all MCP servers is maintained in [STATUS.md](STATUS.md). Please refer to that file for the latest status of each server. + ## Agents Overview ### Available MCP Servers #### Design & Engineering (3 servers) -| Service | Container Name | Status | Description | -|---------|---------------|--------|-------------| -| kicad-mcp | KNELDevStack-AIMW-kicad-mcp | Documented | PCB design automation with 64 tools, JLCPCB integration (host-only) | -| blender-mcp | KNELDevStack-AIMW-blender-mcp | Pending | 3D modeling, materials, scenes, AI 3D model generation | -| freecad-mcp | KNELDevStack-AIMW-freecad-mcp | Pending | CAD modeling, Python execution, parts library | +| Service | Container Name | Description | +|---------|---------------|-------------| +| kicad-mcp | KNELDevStack-AIMW-kicad-mcp | PCB design automation with 64 tools, JLCPCB integration (host-only) | +| blender-mcp | KNELDevStack-AIMW-blender-mcp | 3D modeling, materials, scenes, AI 3D model generation | +| freecad-mcp | KNELDevStack-AIMW-freecad-mcp | CAD modeling, Python execution, parts library | #### Hosting & Infrastructure (5 servers) -| Service | Container Name | Status | Description | -|---------|---------------|--------|-------------| -| kubernetes-mcp | KNELDevStack-AIMW-kubernetes-mcp | Pending | K8s/OpenShift management (native Go implementation) | -| docker-mcp | KNELDevStack-AIMW-docker-mcp | Pending | Container and compose stack management | -| proxmox-mcp | KNELDevStack-AIMW-proxmox-mcp | Pending | Hypervisor VM/container management | -| terraform-mcp | KNELDevStack-AIMW-terraform-mcp | Pending | IaC automation, HCP Terraform, workspace management | -| cloudron-mcp | KNELDevStack-AIMW-cloudron-mcp | Pending | Self-hosted app management | +| Service | Container Name | Description | +|---------|---------------|-------------| +| kubernetes-mcp | KNELDevStack-AIMW-kubernetes-mcp | K8s/OpenShift management (native Go implementation) | +| docker-mcp | KNELDevStack-AIMW-docker-mcp | Container and compose stack management | +| proxmox-mcp | KNELDevStack-AIMW-proxmox-mcp | Hypervisor VM/container management | +| terraform-mcp | KNELDevStack-AIMW-terraform-mcp | IaC automation, HCP Terraform, workspace management | +| cloudron-mcp | KNELDevStack-AIMW-cloudron-mcp | Self-hosted app management | #### Development Tools (2 servers) -| Service | Container Name | Status | Description | -|---------|---------------|--------|-------------| -| bash-language-server | KNELDevStack-AIMW-bash-language-server | Pending | LSP for bash (diagnostics, completion, formatting) | -| context7-mcp | KNELDevStack-AIMW-context7-mcp | Pending | MCP server framework and SDK for documentation | +| Service | Container Name | Description | +|---------|---------------|-------------| +| bash-language-server | KNELDevStack-AIMW-bash-language-server | LSP for bash (diagnostics, completion, formatting) | +| context7-mcp | KNELDevStack-AIMW-context7-mcp | MCP server framework and SDK for documentation | #### Content Management (4 servers) -| Service | Container Name | Status | Description | -|---------|---------------|--------|-------------| -| nextcloud-mcp | KNELDevStack-AIMW-nextcloud-mcp | Pending | 90+ tools across 8 apps (Notes, Calendar, Files, Deck, etc.) | -| ghost-mcp | KNELDevStack-AIMW-ghost-mcp | Pending | CMS post, member, newsletter management | -| docspace-mcp | KNELDevStack-AIMW-docspace-mcp | Pending | Room, file, collaboration management | -| wordpress-mcp | KNELDevStack-AIMW-wordpress-mcp | Pending | WordPress integration via Abilities API | +| Service | Container Name | Description | +|---------|---------------|-------------| +| nextcloud-mcp | KNELDevStack-AIMW-nextcloud-mcp | 90+ tools across 8 apps (Notes, Calendar, Files, Deck, etc.) | +| ghost-mcp | KNELDevStack-AIMW-ghost-mcp | CMS post, member, newsletter management | +| docspace-mcp | KNELDevStack-AIMW-docspace-mcp | Room, file, collaboration management | +| wordpress-mcp | KNELDevStack-AIMW-wordpress-mcp | WordPress integration via Abilities API | #### Communication & Collaboration (3 servers) -| Service | Container Name | Status | Description | -|---------|---------------|--------|-------------| -| discourse-mcp | KNELDevStack-AIMW-discourse-mcp | Pending | Forum search, posts, topics, categories (read/write modes) | -| imap-mcp | KNELDevStack-AIMW-imap-mcp | Pending | Email browsing, composition, Gmail OAuth2 support | -| postizz-mcp | KNELDevStack-AIMW-postizz-mcp | Pending | Social media management platform | +| Service | Container Name | Description | +|---------|---------------|-------------| +| discourse-mcp | KNELDevStack-AIMW-discourse-mcp | Forum search, posts, topics, categories (read/write modes) | +| imap-mcp | KNELDevStack-AIMW-imap-mcp | Email browsing, composition, Gmail OAuth2 support | +| postizz-mcp | KNELDevStack-AIMW-postizz-mcp | Social media management platform | #### Analytics & Security (2 servers) -| Service | Container Name | Status | Description | -|---------|---------------|--------|-------------| -| matomo-mcp | KNELDevStack-AIMW-matomo-mcp | Pending | Analytics integration | -| bitwarden-mcp | KNELDevStack-AIMW-bitwarden-mcp | Pending | Official password vault management | +| Service | Container Name | Description | +|---------|---------------|-------------| +| matomo-mcp | KNELDevStack-AIMW-matomo-mcp | Analytics integration | +| bitwarden-mcp | KNELDevStack-AIMW-bitwarden-mcp | Official password vault management | #### Productivity & Automation (6 servers) -| Service | Container Name | Status | Description | -|---------|---------------|--------|-------------| -| gimp-mcp | KNELDevStack-AIMW-gimp-mcp | Pending | Image editing with GIMP 3.0, OCR support | -| snipeit-mcp | KNELDevStack-AIMW-snipeit-mcp | Pending | Asset inventory, maintenance tracking | -| mcp-redmine | KNELDevStack-AIMW-mcp-redmine | Pending | Project management, issue tracking, file operations | -| mcp-ansible | KNELDevStack-AIMW-mcp-ansible | Pending | IT automation playbooks | -| elasticsearch-mcp | KNELDevStack-AIMW-elasticsearch-mcp | Pending | Search and index management (Rust) | -| audiobook-mcp | KNELDevStack-AIMW-audiobook-mcp | Pending | Audiobook management with AI-powered features | +| Service | Container Name | Description | +|---------|---------------|-------------| +| gimp-mcp | KNELDevStack-AIMW-gimp-mcp | Image editing with GIMP 3.0, OCR support | +| snipeit-mcp | KNELDevStack-AIMW-snipeit-mcp | Asset inventory, maintenance tracking | +| mcp-redmine | KNELDevStack-AIMW-mcp-redmine | Project management, issue tracking, file operations | +| mcp-ansible | KNELDevStack-AIMW-mcp-ansible | IT automation playbooks | +| elasticsearch-mcp | KNELDevStack-AIMW-elasticsearch-mcp | Search and index management (Rust) | +| audiobook-mcp | KNELDevStack-AIMW-audiobook-mcp | Audiobook management with AI-powered features | #### Additional Tools (3 servers) -| Service | Container Name | Status | Description | -|---------|---------------|--------|-------------| -| drawio-mcp | KNELDevStack-AIMW-drawio-mcp | Pending | Draw.io diagram management | -| docker-language-server | KNELDevStack-AIMW-docker-language-server | Pending | Language server for Dockerfiles, Compose files, Bake files | -| penpot-mcp | KNELDevStack-AIMW-penpot-mcp | Pending | Design collaboration platform integration | +| Service | Container Name | Description | +|---------|---------------|-------------| +| drawio-mcp | KNELDevStack-AIMW-drawio-mcp | Draw.io diagram management | +| docker-language-server | KNELDevStack-AIMW-docker-language-server | Language server for Dockerfiles, Compose files, Bake files | +| penpot-mcp | KNELDevStack-AIMW-penpot-mcp | Design collaboration platform integration | ## Agent Capabilities @@ -154,6 +156,18 @@ docker compose stop ## Development Notes +### Critical: STATUS.md Maintenance + +**STATUS.md MUST always be kept fully up to date** as it is the single source of truth for operational status of all MCP servers in this project. + +When working on any MCP server: +1. **Before starting work**: Review current status in STATUS.md +2. **During work**: Update STATUS.md immediately after each significant milestone (build, start, validation, issues) +3. **After completing work**: Ensure STATUS.md accurately reflects final status with relevant notes +4. **Commit STATUS.md changes**: Always commit STATUS.md updates in separate atomic commits with clear commit messages + +### Project Conventions + - All containers use the prefix `KNELDevStack-AIMW-` for easy identification - Container names are in PascalCase for readability - Service names are lowercase for Docker Compose compatibility