From 1c1b44c0257ebc8e8b2a3218948ef95792acce3b Mon Sep 17 00:00:00 2001 From: Charles N Wyble Date: Wed, 21 Jan 2026 17:45:48 -0500 Subject: [PATCH] docs: refactor AGENTS.md to reference STATUS.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Removed Status column from all tables to eliminate duplication Added prominent note about STATUS.md being single source of truth Added comprehensive STATUS.md maintenance instructions Emphasized that STATUS.md must be kept current at all times Commit STATUS.md updates in separate atomic commits 💘 Generated with Crush Co-Authored-By: Crush --- AGENTS.md | 102 +++++++++++++++++++++++++++++++----------------------- 1 file changed, 58 insertions(+), 44 deletions(-) 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