Fix MCP servers: use npx instead of uvx

- Install MCP servers via npm in Dockerfile
- Update agent.toml to use npx commands instead of uvx
- Fix MCP server connection issues by using Node.js package manager
- Keep all four MCP servers (filesystem, git, memory, sequential-thinking)
- Fix some bugs in demo

Author: 53gf4u1t

community/archmind/.gitignore

@@ -0,0 +1,5 @@
+# Env vars
+.env.*
+
+# Example repo
+target-repo

community/archmind/Dockerfile

@@ -4,22 +4,18 @@ FROM node:18-alpine
 RUN apk add --no-cache git python3 py3-pip
 
 # Install Qodo CLI
-RUN npm install -g @qodo/cli
+RUN npm install -g @qodo/command
 
-# Install MCP servers
-RUN pip3 install mcp-server-filesystem mcp-server-git mcp-server-memory
+# Install MCP servers via npm
+RUN npm install -g @modelcontextprotocol/server-memory @modelcontextprotocol/server-filesystem @modelcontextprotocol/server-git
 
 # Create working directory
 WORKDIR /workspace
 
-# Copy agent configuration
-COPY agent.toml /workspace/
+# Copy agent configuration to working directory
+COPY agent.toml /workspace/agent.toml
 COPY README.md /workspace/
 COPY examples/ /workspace/examples/
 
-# Set up environment
-ENV NODE_ENV=production
-ENV MCP_SERVERS_PATH=/workspace
-
 # Default command
-CMD ["qodo", "archmind", "--help"]
+CMD ["qodo", "archmind", "--help"]

community/archmind/README.md

@@ -23,6 +23,17 @@ This agent is submitted for the **"Best Agent for Complex Codebases"** category
 ### Prerequisites
 - Docker and Docker Compose
 - Git
+- **Qodo API Key** (required for analysis)
+  - Set environment variable: `export QODO_API_KEY=your_key_here`
+
+### Setup API Key
+```bash
+# Get API key from https://qodo.ai
+export QODO_API_KEY=your_api_key_here
+
+# Or create .env file
+echo "QODO_API_KEY=your_key_here" > .env
+```
 
 ### Demo Analysis (Next.js Framework)
 

community/archmind/agent.toml

@@ -203,33 +203,23 @@ arguments = [
     { name = "framework_mode", type = "boolean", required = false, default = false, description = "Enable framework extensibility documentation" }
 ]
 
-# MCP servers for comprehensive analysis
+# MCP servers for comprehensive analysis (using npx)
 mcpServers = """
 {
-    "filesystem": {
-        "command": "uvx",
-        "args": ["mcp-server-filesystem", "."],
-        "env": {}
-    },
-    "git": {
-        "command": "uvx", 
-        "args": ["mcp-server-git", "--repository", "."],
-        "env": {}
-    },
     "memory": {
-        "command": "uvx",
-        "args": ["mcp-server-memory"],
+        "command": "npx",
+        "args": ["@modelcontextprotocol/server-memory"],
         "env": {}
     },
     "sequential-thinking": {
-        "command": "uvx",
-        "args": ["mcp-server-sequential-thinking"],
+        "command": "npx",
+        "args": ["@modelcontextprotocol/server-sequential-thinking"],
         "env": {}
     }
 }
 """
 
-# Available tools for the agent
+# Available tools for the agent (use built-in filesystem and git)
 tools = ["filesystem", "git", "memory", "sequential-thinking"]
 
 # Execution strategy for complex analysis
@@ -242,6 +232,7 @@ output_schema = """
     "properties": {
         "analysis_metadata": {
             "type": "object",
+            "description": "Metadata about the analysis execution including repository info and timing",
             "properties": {
                 "repository_name": {"type": "string"},
                 "analysis_date": {"type": "string"},
@@ -255,6 +246,7 @@ output_schema = """
         },
         "executive_summary": {
             "type": "object",
+            "description": "High-level summary of architectural findings and key metrics",
             "properties": {
                 "architecture_type": {"type": "string"},
                 "complexity_score": {"type": "number", "minimum": 1, "maximum": 10},
@@ -267,6 +259,7 @@ output_schema = """
         },
         "repository_structure": {
             "type": "object",
+            "description": "Analysis of repository organization and file structure patterns",
             "properties": {
                 "components": {"type": "array", "items": {"type": "object"}},
                 "directory_patterns": {"type": "array", "items": {"type": "object"}},
@@ -277,6 +270,7 @@ output_schema = """
         },
         "patterns_detected": {
             "type": "object",
+            "description": "Architectural and design patterns identified in the codebase",
             "properties": {
                 "architectural_patterns": {"type": "array", "items": {"type": "string"}},
                 "design_patterns_inferred": {"type": "array", "items": {"type": "string"}},
@@ -285,17 +279,9 @@ output_schema = """
                 "pattern_confidence": {"type": "object"}
             }
         },
-        "historical_analysis": {
-            "type": "object",
-            "properties": {
-                "evolution_timeline": {"type": "array", "items": {"type": "object"}},
-                "change_hotspots": {"type": "array", "items": {"type": "object"}},
-                "contributor_patterns": {"type": "object"},
-                "architectural_decisions": {"type": "array", "items": {"type": "object"}}
-            }
-        },
         "quality_metrics": {
             "type": "object",
+            "description": "Quantitative metrics about code structure and organization quality",
             "properties": {
                 "structure_organization_score": {"type": "number"},
                 "pattern_consistency_score": {"type": "number"},
@@ -305,6 +291,7 @@ output_schema = """
         },
         "recommendations": {
             "type": "array",
+            "description": "Prioritized list of actionable improvement suggestions",
             "items": {
                 "type": "object",
                 "properties": {
@@ -318,31 +305,34 @@ output_schema = """
                 }
             }
         },
-        "framework_capabilities": {
-            "type": "object",
-            "properties": {
-                "current_phase": {"type": "string"},
-                "available_integrations": {"type": "array", "items": {"type": "string"}},
-                "extension_opportunities": {"type": "array", "items": {"type": "string"}},
-                "roadmap_items": {"type": "array", "items": {"type": "object"}}
-            }
-        },
         "documentation_generated": {
             "type": "object",
+            "description": "Information about documentation files and artifacts created",
             "properties": {
                 "files_created": {"type": "array", "items": {"type": "string"}},
                 "diagrams_generated": {"type": "array", "items": {"type": "string"}},
                 "total_documentation_size": {"type": "string"},
                 "framework_documentation": {"type": "boolean"}
             }
         },
-        "success": {"type": "boolean"},
-        "errors": {"type": "array", "items": {"type": "string"}},
-        "warnings": {"type": "array", "items": {"type": "string"}}
+        "success": {
+            "type": "boolean",
+            "description": "Whether the analysis completed successfully"
+        },
+        "errors": {
+            "type": "array",
+            "description": "List of errors encountered during analysis",
+            "items": {"type": "string"}
+        },
+        "warnings": {
+            "type": "array", 
+            "description": "List of warnings or non-critical issues found",
+            "items": {"type": "string"}
+        }
     },
     "required": ["analysis_metadata", "executive_summary", "success"]
 }
 """
 
-# Success condition for CI/CD integration
-exit_expression = "success && executive_summary.health_score >= 6"
+# Success condition for CI/CD integration (fixed JMESPath)
+exit_expression = "success == `true` && executive_summary.health_score >= `6`"

community/archmind/docker-compose.yml

@@ -1,23 +1,26 @@
-version: '3.8'
 services:
   archmind:
     build: .
     volumes:
-      - ./target-repo:/workspace
+      - ./target-repo:/workspace/repo
+      - ./agent.toml:/workspace/agent.toml
       - ./output:/workspace/analysis
     working_dir: /workspace
     environment:
-      - QODO_MODEL=claude-3-5-sonnet-20241022
-    command: qodo archmind --analysis-depth=deep --generate-docs=true
+      - QODO_MODEL=claude-sonnet-4@20250514
+      - QODO_API_KEY=${QODO_API_KEY}
+    command: qodo archmind --agent-file=agent.toml --analysis-depth=deep --generate-docs=true
 
   archmind-interactive:
     build: .
     volumes:
-      - ./target-repo:/workspace
+      - ./target-repo:/workspace/repo
+      - ./agent.toml:/workspace/agent.toml
       - ./output:/workspace/analysis
     working_dir: /workspace
     stdin_open: true
     tty: true
     environment:
       - QODO_MODEL=claude-sonnet-4@20250514
+      - QODO_API_KEY=${QODO_API_KEY}
     command: /bin/sh

community/archmind/examples/ci-cd-integration.yml

@@ -40,6 +40,7 @@ jobs:
             -v ${{ github.workspace }}/analysis:/workspace/analysis \
             ghcr.io/qodo-ai/archmind:latest \
             qodo archmind \
+            --agent-file=agent.toml \
             --analysis-depth=deep \
             --generate-docs=true \
             --include-diagrams=true \
@@ -170,6 +171,7 @@ jobs:
             -v ${{ github.workspace }}:/workspace \
             ghcr.io/qodo-ai/archmind:latest \
             qodo archmind \
+            --agent-file=agent.toml \
             --focus-area=dependencies \
             --output-format=json > dependency-changes.json
             

community/archmind/examples/local-development.md

@@ -25,6 +25,7 @@ docker run --rm \
   -v $PWD/architecture-analysis:/workspace/analysis \
   ghcr.io/qodo-ai/archmind:latest \
   qodo archmind \
+  --agent-file=agent.toml \
   --analysis-depth=expert \
   --include-diagrams=true \
   --focus-area=all \
@@ -42,22 +43,22 @@ docker run --rm -it \
   ghcr.io/qodo-ai/archmind:latest /bin/sh
 
 # Inside container, run various analyses
-qodo archmind --analysis-depth=quick --focus-area=dependencies
-qodo archmind --analysis-depth=deep --focus-area=patterns
-qodo archmind --analysis-depth=expert --include-diagrams=true
+qodo archmind --agent-file=agent.toml --analysis-depth=quick --focus-area=dependencies
+qodo archmind --agent-file=agent.toml --analysis-depth=deep --focus-area=patterns
+qodo archmind --agent-file=agent.toml --analysis-depth=expert --include-diagrams=true
 ```
 
 ### Multiple Analysis Runs
 ```bash
 # Run different analyses for different purposes
 docker run --rm -v $PWD:/workspace ghcr.io/qodo-ai/archmind:latest \
-  qodo archmind --analysis-depth=quick --output-format=json > quick-metrics.json
+  qodo archmind --agent-file=agent.toml --analysis-depth=quick --output-format=json > quick-metrics.json
 
 docker run --rm -v $PWD:/workspace ghcr.io/qodo-ai/archmind:latest \
-  qodo archmind --focus-area=security --output-format=markdown > security-report.md
+  qodo archmind --agent-file=agent.toml --focus-area=security --output-format=markdown > security-report.md
 
 docker run --rm -v $PWD:/workspace ghcr.io/qodo-ai/archmind:latest \
-  qodo archmind --focus-area=performance --include-diagrams=true
+  qodo archmind --agent-file=agent.toml --focus-area=performance --include-diagrams=true
 ```
 
 ## Continuous Analysis
@@ -74,7 +75,7 @@ docker run --rm \
   -v $PWD:/workspace \
   -v $PWD/.architecture:/workspace/analysis \
   ghcr.io/qodo-ai/archmind:latest \
-  qodo archmind --analysis-depth=quick --generate-docs=false
+  qodo archmind --agent-file=agent.toml --analysis-depth=quick --generate-docs=false
 
 # Check for significant architectural changes
 if [ -f ".architecture/metrics.json" ]; then
@@ -101,7 +102,7 @@ echo "Validating architecture before push..."
 docker run --rm \
   -v $PWD:/workspace \
   ghcr.io/qodo-ai/archmind:latest \
-  qodo archmind --analysis-depth=standard --output-format=json > /tmp/arch-check.json
+  qodo archmind --agent-file=agent.toml --analysis-depth=standard --output-format=json > /tmp/arch-check.json
 
 # Check if architecture meets standards
 complexity=$(grep -o '"complexity_score":[0-9]*' /tmp/arch-check.json | cut -d: -f2)
@@ -181,6 +182,7 @@ max_complexity_score = 6
 ```bash
 docker run --rm -v $PWD:/workspace ghcr.io/qodo-ai/archmind:latest \
   qodo archmind \
+  --agent-file=agent.toml \
   --exclude-patterns="node_modules,dist,build,.next" \
   --focus-area=patterns \
   --max-file-count=10000
@@ -190,6 +192,7 @@ docker run --rm -v $PWD:/workspace ghcr.io/qodo-ai/archmind:latest \
 ```bash
 docker run --rm -v $PWD:/workspace ghcr.io/qodo-ai/archmind:latest \
   qodo archmind \
+  --agent-file=agent.toml \
   --exclude-patterns="__pycache__,.venv,venv,*.pyc" \
   --focus-area=dependencies \
   --analysis-depth=deep
@@ -199,6 +202,7 @@ docker run --rm -v $PWD:/workspace ghcr.io/qodo-ai/archmind:latest \
 ```bash
 docker run --rm -v $PWD:/workspace ghcr.io/qodo-ai/archmind:latest \
   qodo archmind \
+  --agent-file=agent.toml \
   --exclude-patterns="target/,*.class,.gradle" \
   --focus-area=all \
   --include-diagrams=true
@@ -221,6 +225,7 @@ docker run --rm -m 4g \
   -v $PWD:/workspace \
   ghcr.io/qodo-ai/archmind:latest \
   qodo archmind \
+  --agent-file=agent.toml \
   --max-file-count=5000 \
   --exclude-patterns="vendor,node_modules,dist,build"
 ```

community/archmind/run-demo.sh

@@ -2,7 +2,19 @@
 set -e
 
 echo "ArchMind Demo - Analyzing Next.js Framework"
-echo "==========================================="
+echo "=============================================="
+
+# Check if API key is set
+if [ -z "$QODO_API_KEY" ]; then
+    echo ""
+    echo "ERROR: Qodo API key required"
+    echo "Please set QODO_API_KEY environment variable"
+    echo "Get your key from https://qodo.ai"
+    echo ""
+    echo "Example: export QODO_API_KEY=your_key_here"
+    echo ""
+    exit 1
+fi
 
 # Clone Next.js repository if not exists
 if [ ! -d "target-repo" ]; then
@@ -14,12 +26,17 @@ fi
 mkdir -p output
 
 echo "Starting ArchMind Docker container..."
-docker-compose up --build archmind
+
+# Run with explicit agent file specification
+docker-compose run --rm archmind qodo archmind \
+    --agent-file=/workspace/agent.toml \
+    --analysis-depth=deep \
+    --generate-docs=true
 
 echo "Analysis complete! Check the output directory for results."
 echo "Generated files:"
 ls -la output/
 
 echo ""
 echo "To run interactive analysis:"
-echo "docker-compose run --rm archmind-interactive"
+echo "docker-compose run --rm archmind-interactive"