claude-autopm 1.13.13 → 1.14.1

package/README.md

@@ -344,6 +344,33 @@ Teams support inheritance, so specialized teams automatically include base agent
 
 ClaudeAutoPM provides comprehensive MCP management for agent-to-tool integration. **39 out of 53 agents (74%)** use MCP servers for live documentation and external tool access.
 
+### 🆕 Dynamic Server Discovery & Installation
+
+**NEW!** Discover and install MCP servers directly from npm registry:
+
+```bash
+# Search for MCP servers
+autopm mcp search filesystem
+autopm mcp search @modelcontextprotocol
+
+# Browse official servers
+autopm mcp browse --official
+
+# Install directly from npm (auto-configures everything)
+autopm mcp install @modelcontextprotocol/server-filesystem --enable
+
+# Uninstall when done
+autopm mcp uninstall filesystem
+```
+
+**Benefits:**
+- 🔍 **Search thousands** of community MCP servers
+- 📦 **One-command install** - npm package + auto-configuration
+- 🔄 **Always up-to-date** - Install latest versions
+- 🗑️ **Clean removal** - Uninstall server + npm package together
+
+**Official MCP Registry**: https://registry.modelcontextprotocol.io
+
 ### Quick Start with MCP
 
 ```bash
@@ -378,7 +405,18 @@ autopm mcp sync
 
 ### MCP Commands
 
-#### **Agent Analysis**
+#### **🔍 Discovery & Installation (NEW!)**
+```bash
+autopm mcp search <query>         # Search npm registry for MCP servers
+autopm mcp browse                 # Browse popular/official servers
+autopm mcp browse --category db   # Browse by category
+autopm mcp install <package>      # Install from npm + auto-configure
+autopm mcp install <pkg> --enable # Install and enable immediately
+autopm mcp uninstall <name>       # Remove server + npm package
+autopm mcp uninstall <name> --keep-package  # Keep npm package
+```
+
+#### **🤖 Agent Analysis**
 ```bash
 autopm mcp agents              # List agents using MCP
 autopm mcp agents --by-server  # Group by MCP server
@@ -387,7 +425,7 @@ autopm mcp usage               # Usage statistics
 autopm mcp tree                # Dependency tree
 ```
 
-#### **Configuration & Diagnostics**
+#### **⚙️ Configuration & Diagnostics**
 ```bash
 autopm mcp check               # Quick configuration check
 autopm mcp setup               # Interactive API key setup
@@ -396,13 +434,15 @@ autopm mcp test <server>       # Test server connection
 autopm mcp status              # Show servers status
 ```
 
-#### **Server Management**
+#### **📦 Server Management**
 ```bash
-autopm mcp list                # List available servers
+autopm mcp list                # List installed servers
+autopm mcp list --detailed     # List with full details
 autopm mcp info <server>       # Server details
 autopm mcp enable <server>     # Enable server
 autopm mcp disable <server>    # Disable server
 autopm mcp sync                # Sync configuration
+autopm mcp validate            # Validate all servers
 ```
 
 ### MCP Server Types

package/autopm/.claude/examples/mcp/README.md

@@ -0,0 +1,109 @@
+# MCP Server Examples
+
+This directory contains example MCP (Model Context Protocol) server configurations that you can use in your projects.
+
+## ⚠️ Important
+
+These are **EXAMPLES ONLY**. They are NOT automatically installed or enabled.
+
+## 🚀 How to Use
+
+### Option 1: Copy to Your Project
+
+```bash
+# Copy a specific example to your project's .claude/mcp/ directory
+cp .claude/examples/mcp/context7-docs.md .claude/mcp/
+
+# Then enable it
+autopm mcp enable context7-docs
+
+# And sync
+autopm mcp sync
+```
+
+### Option 2: Use as Template
+
+```bash
+# Copy and modify
+cp .claude/examples/mcp/github-mcp.md .claude/mcp/my-custom-server.md
+nano .claude/mcp/my-custom-server.md
+
+# Enable and sync
+autopm mcp enable my-custom-server
+autopm mcp sync
+```
+
+### Option 3: Interactive Wizard
+
+```bash
+# Create a new server from scratch
+autopm mcp add
+```
+
+## 📚 Available Examples
+
+### Context7 Servers
+- **context7-docs.md** - Documentation server for technical docs
+- **context7-codebase.md** - Codebase analysis and navigation
+
+### Integration Servers
+- **github-mcp.md** - GitHub repository management
+- **filesystem-mcp.md** - Local filesystem operations
+
+### Testing Servers
+- **playwright-mcp.md** - Browser automation and E2E testing
+
+### Database Servers
+- **sqlite-mcp.md** - SQLite database operations
+
+### Test Servers (For Development)
+- **info-server.md** - Test server for development
+- **test-server.md** - Another test server
+
+## 🔧 Configuration
+
+Each example includes:
+- YAML frontmatter with server configuration
+- Environment variable placeholders
+- Usage examples
+- Setup instructions
+
+Make sure to:
+1. Configure required environment variables in `.claude/.env`
+2. Install required npm packages (e.g., `npm install @upstash/context7-mcp`)
+3. Test the server: `autopm mcp test <server-name>`
+
+## 📝 Example Workflow
+
+```bash
+# 1. Copy example
+cp .claude/examples/mcp/context7-docs.md .claude/mcp/
+
+# 2. Set up environment variables
+echo "CONTEXT7_API_KEY=your-key-here" >> .claude/.env
+
+# 3. Enable the server
+autopm mcp enable context7-docs
+
+# 4. Sync configuration
+autopm mcp sync
+
+# 5. Test the connection
+autopm mcp test context7-docs
+
+# 6. Check status
+autopm mcp status
+```
+
+## 🔐 Security Notes
+
+- Never commit `.claude/.env` with actual API keys
+- Use environment variable substitution: `${VAR_NAME:-default}`
+- Review server permissions before enabling
+- Keep MCP packages updated for security patches
+
+## 📚 Learn More
+
+- [MCP Registry](../../mcp/MCP-REGISTRY.md) - Full documentation
+- [MCP Management Guide](../../../../docs/MCP-MANAGEMENT-GUIDE.md) - Detailed guide
+- Official MCP documentation: https://modelcontextprotocol.io/

package/autopm/.claude/examples/mcp-servers.example.json

@@ -0,0 +1,126 @@
+{
+  "mcpServers": {
+    "context7-docs": {
+      "command": "npx",
+      "args": ["@upstash/context7-mcp"],
+      "env": {
+        "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY:-}",
+        "CONTEXT7_MCP_URL": "${CONTEXT7_MCP_URL:-https://mcp.context7.com/mcp}",
+        "CONTEXT7_API_URL": "${CONTEXT7_API_URL:-https://context7.com/api/v1}",
+        "CONTEXT7_WORKSPACE": "${CONTEXT7_WORKSPACE:-}",
+        "CONTEXT7_MODE": "documentation"
+      },
+      "envFile": ".claude/.env"
+    },
+    "context7-codebase": {
+      "command": "npx",
+      "args": ["@upstash/context7-mcp"],
+      "env": {
+        "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY:-}",
+        "CONTEXT7_MCP_URL": "${CONTEXT7_MCP_URL:-https://mcp.context7.com/mcp}",
+        "CONTEXT7_API_URL": "${CONTEXT7_API_URL:-https://context7.com/api/v1}",
+        "CONTEXT7_WORKSPACE": "${CONTEXT7_WORKSPACE:-}",
+        "CONTEXT7_MODE": "codebase"
+      },
+      "envFile": ".claude/.env"
+    },
+    "playwright-mcp": {
+      "command": "npx",
+      "args": ["@playwright/mcp"],
+      "env": {
+        "PLAYWRIGHT_BROWSER": "chromium",
+        "PLAYWRIGHT_HEADLESS": "true"
+      }
+    }
+  },
+  "contextPools": {
+    "python-docs": {
+      "type": "shared",
+      "agents": ["python-backend-engineer", "mcp-context-manager"],
+      "sources": ["context7-docs"],
+      "filters": ["fastapi", "sqlalchemy", "pydantic", "uvicorn", "pytest"],
+      "maxSize": "100MB",
+      "retention": "7d",
+      "refresh": "daily"
+    },
+    "azure-docs": {
+      "type": "shared",
+      "agents": ["azure-devops-specialist", "mcp-context-manager"],
+      "sources": ["context7-docs"],
+      "filters": ["azure-devops", "rest-api", "work-items", "pipelines"],
+      "maxSize": "75MB",
+      "retention": "7d",
+      "refresh": "daily"
+    },
+    "react-docs": {
+      "type": "shared",
+      "agents": ["react-frontend-engineer", "playwright-test-engineer"],
+      "sources": ["context7-docs"],
+      "filters": ["react", "nextjs", "typescript", "tailwind", "vite"],
+      "maxSize": "75MB",
+      "retention": "7d",
+      "refresh": "daily"
+    },
+    "cloud-docs": {
+      "type": "shared",
+      "agents": ["gcp-cloud-architect", "azure-cloud-architect", "aws-cloud-architect"],
+      "sources": ["context7-docs"],
+      "filters": ["terraform", "kubernetes", "docker", "helm"],
+      "maxSize": "150MB",
+      "retention": "7d",
+      "refresh": "daily"
+    },
+    "devops-context": {
+      "type": "shared",
+      "agents": ["github-operations-specialist", "kubernetes-orchestrator", "azure-devops-specialist"],
+      "sources": ["context7-docs"],
+      "filters": ["github-actions", "kubernetes", "ci-cd"],
+      "maxSize": "100MB",
+      "retention": "7d",
+      "refresh": "daily"
+    },
+    "testing-context": {
+      "type": "shared",
+      "agents": ["playwright-test-engineer", "test-runner"],
+      "sources": ["context7-docs", "playwright-mcp"],
+      "filters": ["playwright", "testing", "e2e"],
+      "maxSize": "50MB",
+      "retention": "7d",
+      "refresh": "daily"
+    },
+    "project-context": {
+      "type": "persistent",
+      "agents": ["python-backend-engineer", "react-frontend-engineer", "azure-devops-specialist", "code-analyzer"],
+      "sources": ["context7-codebase"],
+      "maxSize": "300MB",
+      "retention": "30d",
+      "refresh": "on-change"
+    }
+  },
+  "documentationSources": {
+    "fastapi": {
+      "url": "https://fastapi.tiangolo.com",
+      "type": "api-docs",
+      "priority": "high",
+      "agents": ["python-backend-engineer"]
+    },
+    "sqlalchemy": {
+      "url": "https://docs.sqlalchemy.org/en/20/",
+      "type": "orm-docs",
+      "priority": "high",
+      "agents": ["python-backend-engineer"]
+    },
+    "azure-devops-rest": {
+      "url": "https://docs.microsoft.com/en-us/rest/api/azure/devops/",
+      "type": "api-reference",
+      "priority": "high",
+      "agents": ["azure-devops-specialist"]
+    },
+    "azure-devops-services": {
+      "url": "https://docs.microsoft.com/en-us/azure/devops/",
+      "type": "service-docs",
+      "priority": "medium",
+      "agents": ["azure-devops-specialist"]
+    }
+  }
+}

package/autopm/.claude/mcp/MCP-REGISTRY.md

@@ -1,62 +1,115 @@
 # MCP Server Registry
 
-This document provides the official registry of all MCP (Model Context Protocol) servers distributed with ClaudeAutoPM.
+This document provides guidance on MCP (Model Context Protocol) server management in ClaudeAutoPM.
 
-## 📡 Available MCP Servers
+## 📡 MCP Servers
 
-### context7-docs
+**By default, NO MCP servers are installed.** You must add and configure servers based on your project needs.
+
+## 📚 Available Example Servers
 
-**Location**: `.claude/mcp/context7-docs.md`
+Example MCP server configurations are available in `.claude/examples/mcp/`:
+
+### context7-docs
 **Description**: Context7 documentation server for accessing technical documentation
-**Status**: Active
 **Use Cases**: API documentation, framework guides, technical references
+**Example**: `.claude/examples/mcp/context7-docs.md`
 
 ### context7-codebase
-
-**Location**: `.claude/mcp/context7-codebase.md`
 **Description**: Context7 codebase server for project code analysis
-**Status**: Active
 **Use Cases**: Code navigation, project analysis, dependency tracking
+**Example**: `.claude/examples/mcp/context7-codebase.md`
 
 ### playwright-mcp
-
-**Location**: `.claude/mcp/playwright-mcp.md`
 **Description**: Playwright MCP server for browser automation and testing
-**Status**: Active
 **Use Cases**: E2E testing, visual testing, browser automation
+**Example**: `.claude/examples/mcp/playwright-mcp.md`
 
 ### github-mcp
-
-**Location**: `.claude/mcp/github-mcp.md`
 **Description**: GitHub MCP server for repository management
-**Status**: Active
 **Use Cases**: Issue tracking, PR management, repository analysis
+**Example**: `.claude/examples/mcp/github-mcp.md`
 
 ### filesystem-mcp
-
-**Location**: `.claude/mcp/filesystem-mcp.md`
 **Description**: Local filesystem access server
-**Status**: Active
 **Use Cases**: File operations, directory navigation, content management
+**Example**: `.claude/examples/mcp/filesystem-mcp.md`
 
 ### sqlite-mcp
-
-**Location**: `.claude/mcp/sqlite-mcp.md`
 **Description**: SQLite database server
-**Status**: Active
 **Use Cases**: Local database operations, data analysis, SQL queries
+**Example**: `.claude/examples/mcp/sqlite-mcp.md`
 
 ## 🔧 Server Management
 
-### Adding a New Server
+### 🔍 Discovering Servers (Dynamic)
 
+**NEW: Search NPM Registry**
+```bash
+# Search for MCP servers in npm registry
+autopm mcp search filesystem
+autopm mcp search @modelcontextprotocol
+autopm mcp search azure
+
+# Browse popular servers
+autopm mcp browse
+autopm mcp browse --category database
+autopm mcp browse --official  # Only @modelcontextprotocol/* servers
+```
+
+**Official MCP Registry**: https://registry.modelcontextprotocol.io
+
+### 📦 Installing Servers (Dynamic)
+
+**NEW: Install from NPM**
+```bash
+# Install npm package + create server definition automatically
+autopm mcp install @modelcontextprotocol/server-filesystem
+
+# Install with custom name
+autopm mcp install @modelcontextprotocol/server-memory --name memory
+
+# Install and enable immediately
+autopm mcp install @playwright/mcp --enable
+```
+
+This command will:
+1. Install the npm package (locally or globally based on config)
+2. Auto-generate the `.md` definition file
+3. Optionally enable the server
+4. Update configuration
+
+### 🗑️ Uninstalling Servers (Dynamic)
+
+**NEW: Complete Removal**
+```bash
+# Remove server definition + npm package
+autopm mcp uninstall filesystem
+
+# Keep npm package, only remove definition
+autopm mcp uninstall memory --keep-package
+
+# Force removal even if active
+autopm mcp uninstall context7-docs --force
+```
+
+### ➕ Adding Servers (Manual)
+
+**Option 1: Interactive Wizard**
 ```bash
 autopm mcp add
 ```
 
-This will launch an interactive wizard to create a new server definition.
+**Option 2: Copy from Examples**
+```bash
+# Copy an example to your project
+cp .claude/examples/mcp/context7-docs.md .claude/mcp/
+
+# Or from installed framework
+cp /path/to/framework/autopm/.claude/examples/mcp/github-mcp.md .claude/mcp/
+```
 
-### Enabling/Disabling Servers
+### ✅ Enabling/Disabling Servers
 
 ```bash
 # Enable a server in your project
@@ -64,13 +117,35 @@ autopm mcp enable <server-name>
 
 # Disable a server in your project
 autopm mcp disable <server-name>
+
+# Enable multiple servers
+autopm mcp enable context7-docs context7-codebase playwright-mcp
+```
+
+### 📋 Listing Servers
+
+```bash
+# List all servers in your project
+autopm mcp list
+
+# List with detailed info
+autopm mcp list --detailed
+
+# List only active servers
+autopm mcp list --active
 ```
 
-### Syncing Configuration
+### 🔄 Syncing Configuration
 
 ```bash
 # Sync active servers to .claude/mcp-servers.json
 autopm mcp sync
+
+# Validate configuration
+autopm mcp validate
+
+# Test a specific server
+autopm mcp test <server-name>
 ```
 
 ## 📋 Server Definition Format
@@ -86,7 +161,7 @@ env:
   ENV_VAR: "${ENV_VAR:-default}"
 envFile: .claude/.env
 description: Server description
-category: documentation|codebase|testing|database
+category: documentation|codebase|testing|database|integration
 status: active|deprecated
 ---
 
@@ -104,76 +179,62 @@ Example usage...
 
 ## 🏷️ Server Categories
 
-### Documentation Servers
-- context7-docs
-- Custom documentation servers
-
-### Codebase Servers
-- context7-codebase
-- filesystem-mcp
-
-### Testing Servers
-- playwright-mcp
-- Test automation servers
-
-### Integration Servers
-- github-mcp
-- Azure DevOps MCP (coming soon)
-- GitLab MCP (coming soon)
-
-### Database Servers
-- sqlite-mcp
-- PostgreSQL MCP (coming soon)
-- MongoDB MCP (coming soon)
+- **Documentation**: Technical documentation access
+- **Codebase**: Code analysis and navigation
+- **Testing**: Browser automation and E2E testing
+- **Integration**: GitHub, Azure DevOps, etc.
+- **Database**: SQLite, PostgreSQL, MongoDB
 
 ## 🔄 Server Lifecycle
 
-1. **Definition**: Server defined in `.claude/mcp/*.md`
-2. **Registration**: Listed in this registry
-3. **Activation**: Enabled via `autopm mcp enable`
-4. **Configuration**: Stored in project's `config.json`
-5. **Synchronization**: Generated to `.claude/mcp-servers.json`
-6. **Runtime**: Used by Claude Code
+1. **Definition**: Create server file in `.claude/mcp/*.md`
+2. **Configuration**: Edit YAML frontmatter with server settings
+3. **Activation**: Enable via `autopm mcp enable <server-name>`
+4. **Synchronization**: Auto-synced to `.claude/mcp-servers.json`
+5. **Runtime**: Used by Claude Code
 
 ## 📝 Best Practices
 
-1. **Environment Variables**: Use `${VAR:-default}` syntax
-2. **Sensitive Data**: Store in `.claude/.env`
-3. **Categories**: Assign appropriate categories
-4. **Documentation**: Provide clear usage examples
-5. **Versioning**: Include version requirements
+1. **Start Simple**: Only add servers you need
+2. **Environment Variables**: Use `${VAR:-default}` syntax
+3. **Sensitive Data**: Store API keys in `.claude/.env`
+4. **Categories**: Assign appropriate categories for organization
+5. **Documentation**: Include clear usage examples
+6. **Testing**: Use `autopm mcp test <server-name>` to verify configuration
 
 ## 🚀 Quick Start
 
 ```bash
-# List all available servers
+# 1. Check available servers (should be empty initially)
 autopm mcp list
 
-# Enable essential servers
+# 2. Copy an example server you want to use
+cp .claude/examples/mcp/context7-docs.md .claude/mcp/
+
+# 3. Configure environment variables if needed
+nano .claude/.env
+
+# 4. Enable the server
 autopm mcp enable context7-docs
-autopm mcp enable github-mcp
 
-# Sync configuration
+# 5. Sync configuration
 autopm mcp sync
-```
-
-## 📊 Server Statistics
 
-- **Total Servers**: 6
-- **Active**: 6
-- **Deprecated**: 0
-- **Categories**: 5
+# 6. Test the server
+autopm mcp test context7-docs
+```
 
 ## 🔐 Security Considerations
 
-1. Never commit sensitive tokens
-2. Use environment variables for secrets
-3. Validate server sources
+1. Never commit sensitive tokens or API keys
+2. Use environment variables for all secrets
+3. Validate server sources before installation
 4. Review permissions regularly
 5. Audit server access logs
+6. Keep MCP packages updated
 
 ## 📚 Related Documentation
 
 - [MCP Management Guide](../../docs/MCP-MANAGEMENT-GUIDE.md)
 - [Agent-MCP Integration](../agents/AGENT-MCP-INTEGRATION.md)
-- [Context Pools](../context-pools/README.md)
+- [Context Pools](../context-pools/README.md)

package/autopm/.claude/mcp-servers.json

@@ -1,126 +1,5 @@
 {
-  "mcpServers": {
-    "context7-docs": {
-      "command": "npx",
-      "args": ["@upstash/context7-mcp"],
-      "env": {
-        "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY:-}",
-        "CONTEXT7_MCP_URL": "${CONTEXT7_MCP_URL:-https://mcp.context7.com/mcp}",
-        "CONTEXT7_API_URL": "${CONTEXT7_API_URL:-https://context7.com/api/v1}",
-        "CONTEXT7_WORKSPACE": "${CONTEXT7_WORKSPACE:-}",
-        "CONTEXT7_MODE": "documentation"
-      },
-      "envFile": ".claude/.env"
-    },
-    "context7-codebase": {
-      "command": "npx",
-      "args": ["@upstash/context7-mcp"],
-      "env": {
-        "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY:-}",
-        "CONTEXT7_MCP_URL": "${CONTEXT7_MCP_URL:-https://mcp.context7.com/mcp}",
-        "CONTEXT7_API_URL": "${CONTEXT7_API_URL:-https://context7.com/api/v1}",
-        "CONTEXT7_WORKSPACE": "${CONTEXT7_WORKSPACE:-}",
-        "CONTEXT7_MODE": "codebase"
-      },
-      "envFile": ".claude/.env"
-    },
-    "playwright-mcp": {
-      "command": "npx",
-      "args": ["@playwright/mcp"],
-      "env": {
-        "PLAYWRIGHT_BROWSER": "chromium",
-        "PLAYWRIGHT_HEADLESS": "true"
-      }
-    }
-  },
-  "contextPools": {
-    "python-docs": {
-      "type": "shared",
-      "agents": ["python-backend-engineer", "mcp-context-manager"],
-      "sources": ["context7-docs"],
-      "filters": ["fastapi", "sqlalchemy", "pydantic", "uvicorn", "pytest"],
-      "maxSize": "100MB",
-      "retention": "7d",
-      "refresh": "daily"
-    },
-    "azure-docs": {
-      "type": "shared",
-      "agents": ["azure-devops-specialist", "mcp-context-manager"], 
-      "sources": ["context7-docs"],
-      "filters": ["azure-devops", "rest-api", "work-items", "pipelines"],
-      "maxSize": "75MB",
-      "retention": "7d", 
-      "refresh": "daily"
-    },
-    "react-docs": {
-      "type": "shared",
-      "agents": ["react-frontend-engineer", "playwright-test-engineer"],
-      "sources": ["context7-docs"],
-      "filters": ["react", "nextjs", "typescript", "tailwind", "vite"],
-      "maxSize": "75MB",
-      "retention": "7d",
-      "refresh": "daily"
-    },
-    "cloud-docs": {
-      "type": "shared", 
-      "agents": ["gcp-cloud-architect", "azure-cloud-architect", "aws-cloud-architect"],
-      "sources": ["context7-docs"],
-      "filters": ["terraform", "kubernetes", "docker", "helm"],
-      "maxSize": "150MB",
-      "retention": "7d",
-      "refresh": "daily"
-    },
-    "devops-context": {
-      "type": "shared",
-      "agents": ["github-operations-specialist", "kubernetes-orchestrator", "azure-devops-specialist"],
-      "sources": ["context7-docs"],
-      "filters": ["github-actions", "kubernetes", "ci-cd"],
-      "maxSize": "100MB",
-      "retention": "7d",
-      "refresh": "daily"
-    },
-    "testing-context": {
-      "type": "shared",
-      "agents": ["playwright-test-engineer", "test-runner"],
-      "sources": ["context7-docs", "playwright-mcp"],
-      "filters": ["playwright", "testing", "e2e"],
-      "maxSize": "50MB",
-      "retention": "7d", 
-      "refresh": "daily"
-    },
-    "project-context": {
-      "type": "persistent",
-      "agents": ["python-backend-engineer", "react-frontend-engineer", "azure-devops-specialist", "code-analyzer"],
-      "sources": ["context7-codebase"],
-      "maxSize": "300MB",
-      "retention": "30d",
-      "refresh": "on-change"
-    }
-  },
-  "documentationSources": {
-    "fastapi": {
-      "url": "https://fastapi.tiangolo.com",
-      "type": "api-docs",
-      "priority": "high",
-      "agents": ["python-backend-engineer"]
-    },
-    "sqlalchemy": {
-      "url": "https://docs.sqlalchemy.org/en/20/",
-      "type": "orm-docs", 
-      "priority": "high",
-      "agents": ["python-backend-engineer"]
-    },
-    "azure-devops-rest": {
-      "url": "https://docs.microsoft.com/en-us/rest/api/azure/devops/",
-      "type": "api-reference",
-      "priority": "high", 
-      "agents": ["azure-devops-specialist"]
-    },
-    "azure-devops-services": {
-      "url": "https://docs.microsoft.com/en-us/azure/devops/",
-      "type": "service-docs",
-      "priority": "medium",
-      "agents": ["azure-devops-specialist"]
-    }
-  }
-}
+  "mcpServers": {},
+  "contextPools": {},
+  "documentationSources": {}
+}

package/bin/commands/config.js

@@ -104,30 +104,28 @@ class ConfigCommand {
 
     console.log('│                                         │');
 
-    // MCP Configuration - check both config and mcp-servers.json
+    // MCP Configuration - check actual .md files in project
     const mcpActiveServers = config.mcp?.activeServers || [];
-    let mcpConfiguredServers = 0;
-
-    // If no active servers in config, check mcp-servers.json
-    if (mcpActiveServers.length === 0) {
-      const mcpServersPath = path.join(process.cwd(), '.claude', 'mcp-servers.json');
-      if (await fs.pathExists(mcpServersPath)) {
-        try {
-          const mcpServers = await fs.readJson(mcpServersPath);
-          mcpConfiguredServers = Object.keys(mcpServers.mcpServers || {}).length;
-        } catch (error) {
-          // Ignore error
-        }
+    let mcpAvailableServers = 0;
+
+    // Count actual server definition files (.md) in .claude/mcp/
+    const mcpDir = path.join(process.cwd(), '.claude', 'mcp');
+    if (await fs.pathExists(mcpDir)) {
+      try {
+        const files = await fs.readdir(mcpDir);
+        mcpAvailableServers = files.filter(f => f.endsWith('.md') && f !== 'MCP-REGISTRY.md').length;
+      } catch (error) {
+        // Ignore error
       }
     }
 
     let mcpStatus;
     if (mcpActiveServers.length > 0) {
-      mcpStatus = `✅ ${mcpActiveServers.length} active`;
-    } else if (mcpConfiguredServers > 0) {
-      mcpStatus = `⚠️  ${mcpConfiguredServers} configured`;
+      mcpStatus = `✅ ${mcpActiveServers.length} active (${mcpAvailableServers} total)`;
+    } else if (mcpAvailableServers > 0) {
+      mcpStatus = `⚠️  ${mcpAvailableServers} available, 0 active`;
     } else {
-      mcpStatus = '❌ Not configured';
+      mcpStatus = '⚪ No servers installed';
     }
     console.log(`│ MCP:             ${this.padRight(mcpStatus, 22)} │`);
 
@@ -211,17 +209,17 @@ class ConfigCommand {
     }
 
     if (mcpActiveServers.length === 0) {
-      if (mcpConfiguredServers > 0) {
+      if (mcpAvailableServers > 0) {
         issues.push({
           icon: 'ℹ️',
-          problem: `${mcpConfiguredServers} MCP server(s) configured but not active`,
+          problem: `${mcpAvailableServers} MCP server(s) available but not active`,
           solution: 'Run: autopm mcp list  (then: autopm mcp enable <server>)'
         });
       } else {
         issues.push({
           icon: 'ℹ️',
-          problem: 'No MCP servers configured',
-          solution: 'Run: autopm mcp list  (to see available servers)'
+          problem: 'No MCP servers installed',
+          solution: 'Add servers from examples: cp .claude/examples/mcp/*.md .claude/mcp/'
         });
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-autopm",
-  "version": "1.13.13",
+  "version": "1.14.1",
   "description": "Autonomous Project Management Framework for Claude Code - Advanced AI-powered development automation",
   "main": "bin/autopm.js",
   "bin": {

package/scripts/mcp-handler.js

@@ -47,7 +47,7 @@ class MCPHandler {
   constructor() {
     this.projectRoot = process.cwd();
     this.frameworkRoot = path.join(__dirname, '..');
-    this.mcpDir = path.join(this.frameworkRoot, 'autopm', '.claude', 'mcp');
+    this.mcpDir = path.join(this.projectRoot, '.claude', 'mcp');
     this.configPath = path.join(this.projectRoot, '.claude', 'config.json');
     this.mcpServersPath = path.join(this.projectRoot, '.claude', 'mcp-servers.json');
     this.envPath = path.join(this.projectRoot, '.claude', '.env');