9 Commits

Author SHA1 Message Date
Charles N Wyble
fedd591b75 docs: add production readiness documentation
- Created PRODUCTION-READY.md with 31 deployable servers
- Updated README.md with production status badges and markers
  -  Production Ready (no config needed)
  - ⚠️ Config Required (works with backend)
  -  Not Production Ready (blocked)
- Updated STATUS.md with production summary table
- Added legend for status indicators

Production status: 31/42 servers (74%) ready for deployment

💘 Generated with Crush

Assisted-by: GLM-5 via Crush <crush@charm.land>
2026-02-27 10:46:24 -05:00
Charles N Wyble
855b6e1f22 feat: add firefly-iii-mcp and paperless-mcp MCP servers
- Added firefly-iii-mcp (v1.3.0) for personal finance management
  - Uses npm package @firefly-iii-mcp/local instead of source build
  - Requires FIREFLY_III_BASE_URL and FIREFLY_III_PAT env vars
- Added paperless-mcp (v1.0.0) for document management
  - Requires PAPERLESS_URL and PAPERLESS_TOKEN CLI args
- Created wrapper scripts for Crush integration
- Updated docker-compose.yml with new services
- Updated .env.example with required environment variables
- Added Financial & Budgeting category to README.md

Both servers validated with MCP protocol handshake.

Working MCP servers count: 27

💘 Generated with Crush

Assisted-by: GLM-5 via Crush <crush@charm.land>
2026-02-27 10:10:35 -05:00
Charles N Wyble
cde8838133 docs: refactor AGENTS.md and README.md for proper separation of concerns
AGENTS.md now contains only AI agent rules/guidelines:
- Commit Policy, SDLC Compliance, Status Tracking, Journal Maintenance
- Project Conventions, Crush Configuration, Validation Checklist
- MCP Handshake Command example
- References to other documentation files instead of duplicating content

README.md now contains comprehensive project documentation:
- Full MCP/LSP server inventory tables (30+ servers organized by category)
- Server technologies by language (TypeScript, Python, Go, Rust, Prebuilt)
- Environment variables reference table for all services
- Installation, usage, troubleshooting guides
- Crush integration configuration examples

This refactoring ensures:
- AGENTS.md is a concise reference for AI agent behavior (~107 lines)
- README.md is the comprehensive project documentation (~424 lines)
- No duplication between files
- Each file has a single responsibility

💔 Generated with Crush

Assisted-by: GLM-5 via Crush <crush@charm.land>
2026-02-20 09:52:02 -05:00
Charles N Wyble
bdadb891f2 docs(readme): update script paths and remove Makefile references
Changes:
- Updated all script references to use scripts/ prefix
- Updated vendor repository count from 32+ to 40+
- Removed Makefile targets section (Makefile no longer primary interface)

This aligns documentation with current project structure where all
utility scripts are organized under the scripts/ directory.
2026-02-20 09:26:19 -05:00
Charles N Wyble
ff5c73de7c docs: validate all MCP servers with protocol handshake
- Added matomo-mcp, mcp-redmine, paperless-mcp to working servers list
- Documented runtime failures (nextcloud, imap, webserial, kicad)
- Documented transport mismatches (postizz, penpot)
- Updated README.md vendor count and date
- Added JOURNAL entry for mock credential validation

💔 Generated with Crush

Assisted-by: GLM-5 via Crush <crush@charm.land>
2026-02-19 12:35:31 -05:00
ab21749a16 docs: update container name references to lowercase kneldevstack-aimiddleware-*
- AGENTS.md: Update all 29 container names in tables and Crush integration examples
- README.md: Update container names in Crush integration, troubleshooting, and project structure examples
- STATUS.md: Update container prefix note to reflect new naming convention

Aligns documentation with docker-compose.yml changes for consistency.
2026-01-22 10:05:43 -05:00
49256e20fa docs: Add setup scripts documentation to README.md
Added sections:
- Setup Scripts documentation (CloneVendorRepos.sh, BuildAll.sh, CleanVendor.sh, StatusCheck.sh)
- Makefile targets documentation with examples
- Clarification that vendor/ directory is gitignored and created automatically

Note: Updated Quick Start section to include information about setup scripts and Makefile targets
2026-01-21 19:39:35 -05:00
add39a2671 Enhance README.md with comprehensive documentation
- Add project badges (Docker, License, MCP, LSP)
- Add overview with use cases for OpenWebUI and Crush
- Add features section
- Add installation guide with prerequisites and quick start
- Add Docker Compose usage documentation
- Add Crush integration section with crush.json examples
- Add project structure explanation with dockerfiles/ management
- Add environment variables reference table
- Add troubleshooting guide
- Replace status table with link to STATUS.md (avoids duplication)
- Add contributing section
- Add acknowledgments section
2026-01-21 19:19:23 -05:00
226a37a3f7 Initial commit 2026-01-21 17:47:36 +00:00