KNEL/KNEL-AIMiddleware
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: refactor AGENTS.md to reference STATUS.md

Browse Source 
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 <crush@charm.land>
This commit is contained in:
Charles N Wyble
2026-01-21 17:45:48 -05:00
parent b4f9040171
commit 1c1b44c025
1 changed files with 58 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files

102
AGENTS.md
View File

@@ -2,69 +2,71 @@
This document tracks the AI agents and MCP servers configured in this project. 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 ## Agents Overview
### Available MCP Servers ### Available MCP Servers
#### Design & Engineering (3 servers) #### Design & Engineering (3 servers)
| Service | Container Name | Status | Description | | Service | Container Name | Description |
|---------|---------------|--------|-------------| |---------|---------------|-------------|
| kicad-mcp | KNELDevStack-AIMW-kicad-mcp | Documented | PCB design automation with 64 tools, JLCPCB integration (host-only) | | kicad-mcp | KNELDevStack-AIMW-kicad-mcp | 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 | | blender-mcp | KNELDevStack-AIMW-blender-mcp | 3D modeling, materials, scenes, AI 3D model generation |
| freecad-mcp | KNELDevStack-AIMW-freecad-mcp | Pending | CAD modeling, Python execution, parts library | | freecad-mcp | KNELDevStack-AIMW-freecad-mcp | CAD modeling, Python execution, parts library |
#### Hosting & Infrastructure (5 servers) #### Hosting & Infrastructure (5 servers)
| Service | Container Name | Status | Description | | Service | Container Name | Description |
|---------|---------------|--------|-------------| |---------|---------------|-------------|
| kubernetes-mcp | KNELDevStack-AIMW-kubernetes-mcp | Pending | K8s/OpenShift management (native Go implementation) | | kubernetes-mcp | KNELDevStack-AIMW-kubernetes-mcp | K8s/OpenShift management (native Go implementation) |
| docker-mcp | KNELDevStack-AIMW-docker-mcp | Pending | Container and compose stack management | | docker-mcp | KNELDevStack-AIMW-docker-mcp | Container and compose stack management |
| proxmox-mcp | KNELDevStack-AIMW-proxmox-mcp | Pending | Hypervisor VM/container management | | proxmox-mcp | KNELDevStack-AIMW-proxmox-mcp | Hypervisor VM/container management |
| terraform-mcp | KNELDevStack-AIMW-terraform-mcp | Pending | IaC automation, HCP Terraform, workspace management | | terraform-mcp | KNELDevStack-AIMW-terraform-mcp | IaC automation, HCP Terraform, workspace management |
| cloudron-mcp | KNELDevStack-AIMW-cloudron-mcp | Pending | Self-hosted app management | | cloudron-mcp | KNELDevStack-AIMW-cloudron-mcp | Self-hosted app management |
#### Development Tools (2 servers) #### Development Tools (2 servers)
| Service | Container Name | Status | Description | | Service | Container Name | Description |
|---------|---------------|--------|-------------| |---------|---------------|-------------|
| bash-language-server | KNELDevStack-AIMW-bash-language-server | Pending | LSP for bash (diagnostics, completion, formatting) | | bash-language-server | KNELDevStack-AIMW-bash-language-server | LSP for bash (diagnostics, completion, formatting) |
| context7-mcp | KNELDevStack-AIMW-context7-mcp | Pending | MCP server framework and SDK for documentation | | context7-mcp | KNELDevStack-AIMW-context7-mcp | MCP server framework and SDK for documentation |
#### Content Management (4 servers) #### Content Management (4 servers)
| Service | Container Name | Status | Description | | Service | Container Name | Description |
|---------|---------------|--------|-------------| |---------|---------------|-------------|
| nextcloud-mcp | KNELDevStack-AIMW-nextcloud-mcp | Pending | 90+ tools across 8 apps (Notes, Calendar, Files, Deck, etc.) | | nextcloud-mcp | KNELDevStack-AIMW-nextcloud-mcp | 90+ tools across 8 apps (Notes, Calendar, Files, Deck, etc.) |
| ghost-mcp | KNELDevStack-AIMW-ghost-mcp | Pending | CMS post, member, newsletter management | | ghost-mcp | KNELDevStack-AIMW-ghost-mcp | CMS post, member, newsletter management |
| docspace-mcp | KNELDevStack-AIMW-docspace-mcp | Pending | Room, file, collaboration management | | docspace-mcp | KNELDevStack-AIMW-docspace-mcp | Room, file, collaboration management |
| wordpress-mcp | KNELDevStack-AIMW-wordpress-mcp | Pending | WordPress integration via Abilities API | | wordpress-mcp | KNELDevStack-AIMW-wordpress-mcp | WordPress integration via Abilities API |
#### Communication & Collaboration (3 servers) #### Communication & Collaboration (3 servers)
| Service | Container Name | Status | Description | | Service | Container Name | Description |
|---------|---------------|--------|-------------| |---------|---------------|-------------|
| discourse-mcp | KNELDevStack-AIMW-discourse-mcp | Pending | Forum search, posts, topics, categories (read/write modes) | | discourse-mcp | KNELDevStack-AIMW-discourse-mcp | Forum search, posts, topics, categories (read/write modes) |
| imap-mcp | KNELDevStack-AIMW-imap-mcp | Pending | Email browsing, composition, Gmail OAuth2 support | | imap-mcp | KNELDevStack-AIMW-imap-mcp | Email browsing, composition, Gmail OAuth2 support |
| postizz-mcp | KNELDevStack-AIMW-postizz-mcp | Pending | Social media management platform | | postizz-mcp | KNELDevStack-AIMW-postizz-mcp | Social media management platform |
#### Analytics & Security (2 servers) #### Analytics & Security (2 servers)
| Service | Container Name | Status | Description | | Service | Container Name | Description |
|---------|---------------|--------|-------------| |---------|---------------|-------------|
| matomo-mcp | KNELDevStack-AIMW-matomo-mcp | Pending | Analytics integration | | matomo-mcp | KNELDevStack-AIMW-matomo-mcp | Analytics integration |
| bitwarden-mcp | KNELDevStack-AIMW-bitwarden-mcp | Pending | Official password vault management | | bitwarden-mcp | KNELDevStack-AIMW-bitwarden-mcp | Official password vault management |
#### Productivity & Automation (6 servers) #### Productivity & Automation (6 servers)
| Service | Container Name | Status | Description | | Service | Container Name | Description |
|---------|---------------|--------|-------------| |---------|---------------|-------------|
| gimp-mcp | KNELDevStack-AIMW-gimp-mcp | Pending | Image editing with GIMP 3.0, OCR support | | gimp-mcp | KNELDevStack-AIMW-gimp-mcp | Image editing with GIMP 3.0, OCR support |
| snipeit-mcp | KNELDevStack-AIMW-snipeit-mcp | Pending | Asset inventory, maintenance tracking | | snipeit-mcp | KNELDevStack-AIMW-snipeit-mcp | Asset inventory, maintenance tracking |
| mcp-redmine | KNELDevStack-AIMW-mcp-redmine | Pending | Project management, issue tracking, file operations | | mcp-redmine | KNELDevStack-AIMW-mcp-redmine | Project management, issue tracking, file operations |
| mcp-ansible | KNELDevStack-AIMW-mcp-ansible | Pending | IT automation playbooks | | mcp-ansible | KNELDevStack-AIMW-mcp-ansible | IT automation playbooks |
| elasticsearch-mcp | KNELDevStack-AIMW-elasticsearch-mcp | Pending | Search and index management (Rust) | | elasticsearch-mcp | KNELDevStack-AIMW-elasticsearch-mcp | Search and index management (Rust) |
| audiobook-mcp | KNELDevStack-AIMW-audiobook-mcp | Pending | Audiobook management with AI-powered features | | audiobook-mcp | KNELDevStack-AIMW-audiobook-mcp | Audiobook management with AI-powered features |
#### Additional Tools (3 servers) #### Additional Tools (3 servers)
| Service | Container Name | Status | Description | | Service | Container Name | Description |
|---------|---------------|--------|-------------| |---------|---------------|-------------|
| drawio-mcp | KNELDevStack-AIMW-drawio-mcp | Pending | Draw.io diagram management | | drawio-mcp | KNELDevStack-AIMW-drawio-mcp | Draw.io diagram management |
| docker-language-server | KNELDevStack-AIMW-docker-language-server | Pending | Language server for Dockerfiles, Compose files, Bake files | | docker-language-server | KNELDevStack-AIMW-docker-language-server | Language server for Dockerfiles, Compose files, Bake files |
| penpot-mcp | KNELDevStack-AIMW-penpot-mcp | Pending | Design collaboration platform integration | | penpot-mcp | KNELDevStack-AIMW-penpot-mcp | Design collaboration platform integration |
## Agent Capabilities ## Agent Capabilities
@@ -154,6 +156,18 @@ docker compose stop <service-name>
## Development Notes ## 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 - All containers use the prefix `KNELDevStack-AIMW-` for easy identification
- Container names are in PascalCase for readability - Container names are in PascalCase for readability
- Service names are lowercase for Docker Compose compatibility - Service names are lowercase for Docker Compose compatibility