claude-autopm 1.14.1 → 1.15.1

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

@@ -12,10 +12,10 @@ These are **EXAMPLES ONLY**. They are NOT automatically installed or enabled.
 
 ```bash
 # Copy a specific example to your project's .claude/mcp/ directory
-cp .claude/examples/mcp/context7-docs.md .claude/mcp/
+cp .claude/examples/mcp/context7.md .claude/mcp/
 
 # Then enable it
-autopm mcp enable context7-docs
+autopm mcp enable context7
 
 # And sync
 autopm mcp sync
@@ -42,9 +42,8 @@ autopm mcp add
 
 ## 📚 Available Examples
 
-### Context7 Servers
-- **context7-docs.md** - Documentation server for technical docs
-- **context7-codebase.md** - Codebase analysis and navigation
+### Documentation Servers
+- **context7.md** - Context7 up-to-date documentation database
 
 ### Integration Servers
 - **github-mcp.md** - GitHub repository management
@@ -77,21 +76,18 @@ Make sure to:
 
 ```bash
 # 1. Copy example
-cp .claude/examples/mcp/context7-docs.md .claude/mcp/
+cp .claude/examples/mcp/context7.md .claude/mcp/
 
-# 2. Set up environment variables
-echo "CONTEXT7_API_KEY=your-key-here" >> .claude/.env
+# 2. Enable the server
+autopm mcp enable context7
 
-# 3. Enable the server
-autopm mcp enable context7-docs
-
-# 4. Sync configuration
+# 3. Sync configuration
 autopm mcp sync
 
-# 5. Test the connection
-autopm mcp test context7-docs
+# 4. Test the connection
+autopm mcp test context7
 
-# 6. Check status
+# 5. Check status
 autopm mcp status
 ```
 

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

@@ -0,0 +1,205 @@
+---
+name: context7
+command: npx
+args: ["-y", "@upstash/context7-mcp"]
+description: MCP server for Context7 - Up-to-date documentation database
+category: documentation
+status: inactive
+env:
+  DEFAULT_MINIMUM_TOKENS: "${DEFAULT_MINIMUM_TOKENS:-10000}"
+---
+
+# Context7 MCP Server
+
+Official MCP server for [Context7](https://context7.com) - provides up-to-date documentation for libraries and frameworks.
+
+## 🎯 Features
+
+- **Up-to-date Documentation**: Always current library documentation
+- **Smart Search**: Resolve library names to Context7 IDs
+- **Token Control**: Configure minimum tokens for documentation retrieval
+- **Multi-library Support**: Access documentation for any supported library
+
+## 📦 Installation
+
+### Option 1: Using AutoPM (Recommended)
+
+```bash
+# Install from npm with automatic configuration
+autopm mcp install @upstash/context7-mcp --enable
+
+# Configure API key
+echo "CONTEXT7_API_KEY=your-key-here" >> .claude/.env
+
+# Test connection
+autopm mcp test context7
+```
+
+### Option 2: Manual Setup
+
+```bash
+# Copy this example to your project
+cp .claude/examples/mcp/context7.md .claude/mcp/
+
+# Enable the server
+autopm mcp enable context7
+
+# Sync configuration
+autopm mcp sync
+```
+
+## 🔑 Configuration
+
+### Environment Variables
+
+Add to `.claude/.env`:
+
+```bash
+# Optional: Minimum tokens for documentation retrieval (default: 10000)
+DEFAULT_MINIMUM_TOKENS=10000
+```
+
+Note: Context7 API key is not required for basic usage.
+
+## 🔧 Available Tools
+
+### 1. `resolve-library-id`
+Resolves a general library name into a Context7-compatible library ID.
+
+**Example:**
+```
+Library: "react" → ID: "react/latest"
+Library: "nextjs" → ID: "next/latest"
+```
+
+### 2. `get-library-docs`
+Fetches documentation for a library using a Context7-compatible library ID.
+
+**Parameters:**
+- `libraryId` (required): Context7 library ID (e.g., "react/latest")
+- `topic` (optional): Specific topic to focus on
+- `tokens` (optional): Minimum tokens to retrieve (default: 10000)
+
+**Example:**
+```
+get-library-docs("react/latest", topic="hooks")
+get-library-docs("nextjs/14", topic="app-router", tokens=15000)
+```
+
+## 📚 Usage in Agent Definitions
+
+Reference Context7 documentation in your agents:
+
+```markdown
+## MCP Servers Used
+
+This agent uses Context7 for up-to-date documentation:
+- `mcp://context7/react/latest` - React documentation
+- `mcp://context7/nextjs/14` - Next.js 14 documentation
+- `mcp://context7/typescript/latest` - TypeScript reference
+```
+
+## 🧪 Testing
+
+```bash
+# Test the connection
+autopm mcp test context7
+
+# Check status
+autopm mcp status
+
+# Verify in Claude Code
+/mcp
+```
+
+## 🔐 Security
+
+- Context7 MCP server does not require authentication for basic usage
+- Never commit `.claude/.env` with sensitive data
+- Review Context7's [privacy policy](https://context7.com/privacy)
+
+## 📖 Supported Libraries
+
+Context7 supports hundreds of libraries including:
+- **Frontend**: React, Vue, Angular, Svelte, Next.js
+- **Backend**: Express, Fastify, NestJS, Django, Flask
+- **Databases**: PostgreSQL, MongoDB, Redis, MySQL
+- **Cloud**: AWS, Azure, GCP services
+- **And many more...**
+
+Visit [Context7](https://context7.com) to browse all available documentation.
+
+## 🆘 Troubleshooting
+
+### Server Not Starting
+
+```bash
+# Check npm package is available
+npm view @upstash/context7-mcp
+
+# Reinstall
+npm install -g @upstash/context7-mcp
+
+# Test manually
+npx -y @upstash/context7-mcp
+```
+
+### Library Not Found
+
+Use `resolve-library-id` to find the correct library ID:
+```
+resolve-library-id("your-library-name")
+```
+
+### Token Limit Issues
+
+Adjust `DEFAULT_MINIMUM_TOKENS` in your environment:
+```bash
+echo "DEFAULT_MINIMUM_TOKENS=5000" >> .claude/.env
+```
+
+## 🔗 Links
+
+- **NPM Package**: https://www.npmjs.com/package/@upstash/context7-mcp
+- **GitHub**: https://github.com/upstash/context7
+- **Context7 Website**: https://context7.com
+- **Documentation**: https://upstash.com/docs/redis/integrations/mcp
+- **Blog Post**: https://upstash.com/blog/context7-mcp
+
+## 📝 Example Agent Configuration
+
+```markdown
+---
+name: react-expert
+description: React development expert with Context7 documentation
+mcpServers:
+  - context7
+---
+
+# React Expert Agent
+
+This agent has access to:
+- `mcp://context7/react/latest` - Current React documentation
+- `mcp://context7/react-router/latest` - React Router docs
+- `mcp://context7/redux/latest` - Redux documentation
+```
+
+## 🎓 Best Practices
+
+1. **Use Specific Library IDs**: `react/18` instead of `react/latest` for stability
+2. **Configure Token Limits**: Adjust based on your needs
+3. **Cache Results**: Context7 provides fresh docs but cache for performance
+4. **Topic Filtering**: Use specific topics to reduce token usage
+5. **Test Regularly**: Ensure documentation sources are accessible
+
+## 🆕 Updates
+
+Context7 MCP server is actively maintained by Upstash. Check for updates:
+
+```bash
+npm update -g @upstash/context7-mcp
+```
+
+---
+
+**Need help?** Visit [Context7 documentation](https://context7.com) or [Upstash support](https://upstash.com/support)

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

@@ -1,6 +1,6 @@
 {
   "mcpServers": {
-    "context7-docs": {
+    "context7": {
       "command": "npx",
       "args": ["@upstash/context7-mcp"],
       "env": {
@@ -12,7 +12,7 @@
       },
       "envFile": ".claude/.env"
     },
-    "context7-codebase": {
+    "context7": {
       "command": "npx",
       "args": ["@upstash/context7-mcp"],
       "env": {
@@ -37,7 +37,7 @@
     "python-docs": {
       "type": "shared",
       "agents": ["python-backend-engineer", "mcp-context-manager"],
-      "sources": ["context7-docs"],
+      "sources": ["context7"],
       "filters": ["fastapi", "sqlalchemy", "pydantic", "uvicorn", "pytest"],
       "maxSize": "100MB",
       "retention": "7d",
@@ -46,7 +46,7 @@
     "azure-docs": {
       "type": "shared",
       "agents": ["azure-devops-specialist", "mcp-context-manager"],
-      "sources": ["context7-docs"],
+      "sources": ["context7"],
       "filters": ["azure-devops", "rest-api", "work-items", "pipelines"],
       "maxSize": "75MB",
       "retention": "7d",
@@ -55,7 +55,7 @@
     "react-docs": {
       "type": "shared",
       "agents": ["react-frontend-engineer", "playwright-test-engineer"],
-      "sources": ["context7-docs"],
+      "sources": ["context7"],
       "filters": ["react", "nextjs", "typescript", "tailwind", "vite"],
       "maxSize": "75MB",
       "retention": "7d",
@@ -64,7 +64,7 @@
     "cloud-docs": {
       "type": "shared",
       "agents": ["gcp-cloud-architect", "azure-cloud-architect", "aws-cloud-architect"],
-      "sources": ["context7-docs"],
+      "sources": ["context7"],
       "filters": ["terraform", "kubernetes", "docker", "helm"],
       "maxSize": "150MB",
       "retention": "7d",
@@ -73,7 +73,7 @@
     "devops-context": {
       "type": "shared",
       "agents": ["github-operations-specialist", "kubernetes-orchestrator", "azure-devops-specialist"],
-      "sources": ["context7-docs"],
+      "sources": ["context7"],
       "filters": ["github-actions", "kubernetes", "ci-cd"],
       "maxSize": "100MB",
       "retention": "7d",
@@ -82,7 +82,7 @@
     "testing-context": {
       "type": "shared",
       "agents": ["playwright-test-engineer", "test-runner"],
-      "sources": ["context7-docs", "playwright-mcp"],
+      "sources": ["context7", "playwright-mcp"],
       "filters": ["playwright", "testing", "e2e"],
       "maxSize": "50MB",
       "retention": "7d",
@@ -91,7 +91,7 @@
     "project-context": {
       "type": "persistent",
       "agents": ["python-backend-engineer", "react-frontend-engineer", "azure-devops-specialist", "code-analyzer"],
-      "sources": ["context7-codebase"],
+      "sources": ["context7"],
       "maxSize": "300MB",
       "retention": "30d",
       "refresh": "on-change"

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

@@ -10,15 +10,15 @@ This document provides guidance on MCP (Model Context Protocol) server managemen
 
 Example MCP server configurations are available in `.claude/examples/mcp/`:
 
-### context7-docs
+### context7
 **Description**: Context7 documentation server for accessing technical documentation
 **Use Cases**: API documentation, framework guides, technical references
-**Example**: `.claude/examples/mcp/context7-docs.md`
+**Example**: `.claude/examples/mcp/context7.md`
 
-### context7-codebase
+### context7
 **Description**: Context7 codebase server for project code analysis
 **Use Cases**: Code navigation, project analysis, dependency tracking
-**Example**: `.claude/examples/mcp/context7-codebase.md`
+**Example**: `.claude/examples/mcp/context7.md`
 
 ### playwright-mcp
 **Description**: Playwright MCP server for browser automation and testing
@@ -90,7 +90,7 @@ autopm mcp uninstall filesystem
 autopm mcp uninstall memory --keep-package
 
 # Force removal even if active
-autopm mcp uninstall context7-docs --force
+autopm mcp uninstall context7 --force
 ```
 
 ### ➕ Adding Servers (Manual)
@@ -103,7 +103,7 @@ autopm mcp add
 **Option 2: Copy from Examples**
 ```bash
 # Copy an example to your project
-cp .claude/examples/mcp/context7-docs.md .claude/mcp/
+cp .claude/examples/mcp/context7.md .claude/mcp/
 
 # Or from installed framework
 cp /path/to/framework/autopm/.claude/examples/mcp/github-mcp.md .claude/mcp/
@@ -119,7 +119,7 @@ autopm mcp enable <server-name>
 autopm mcp disable <server-name>
 
 # Enable multiple servers
-autopm mcp enable context7-docs context7-codebase playwright-mcp
+autopm mcp enable context7 context7 playwright-mcp
 ```
 
 ### 📋 Listing Servers
@@ -209,19 +209,19 @@ Example usage...
 autopm mcp list
 
 # 2. Copy an example server you want to use
-cp .claude/examples/mcp/context7-docs.md .claude/mcp/
+cp .claude/examples/mcp/context7.md .claude/mcp/
 
 # 3. Configure environment variables if needed
 nano .claude/.env
 
 # 4. Enable the server
-autopm mcp enable context7-docs
+autopm mcp enable context7
 
 # 5. Sync configuration
 autopm mcp sync
 
 # 6. Test the server
-autopm mcp test context7-docs
+autopm mcp test context7
 ```
 
 ## 🔐 Security Considerations

package/autopm/.claude/rules/agent-coordination.md

@@ -104,31 +104,31 @@ Notes: Added rate limiting middleware
 ```yaml
 backend-context:
   agents: [python-backend-expert, database-architect]
-  sources: [context7-docs, context7-codebase]
+  sources: [context7, context7]
   filters: [python, fastapi, flask, django, sqlalchemy, databases]
   persistence: true
 
 frontend-context:
   agents: [react-ui-expert, e2e-test-engineer]
-  sources: [context7-docs, context7-codebase]
+  sources: [context7, context7]
   filters: [react, typescript, ui-frameworks, testing]
   persistence: true
 
 infrastructure-context:
   agents: [multi-cloud-architect, kubernetes-orchestrator, docker-containerization-expert]
-  sources: [context7-docs, terraform-registry]
+  sources: [context7, terraform-registry]
   filters: [terraform, kubernetes, docker, cloud-providers]
   persistence: true
 
 devops-context:
   agents: [github-operations-specialist, mcp-context-manager]
-  sources: [context7-docs, github-mcp]
+  sources: [context7, github-mcp]
   filters: [ci-cd, github-actions, azure-devops]
   persistence: false
 
 project-context:
   agents: [ALL]
-  sources: [context7-codebase]
+  sources: [context7]
   persistence: true
   shared: true
   auto-refresh: true

package/bin/commands/mcp.js

@@ -17,6 +17,7 @@ module.exports = {
         type: 'string',
         choices: [
           'list', 'add', 'remove', 'enable', 'disable', 'sync', 'validate', 'info',
+          'search', 'browse', 'install', 'uninstall',
           'agents', 'agent', 'usage', 'setup', 'check', 'diagnose', 'test', 'tree', 'status'
         ]
       })
@@ -39,7 +40,36 @@ module.exports = {
         type: 'boolean',
         default: false
       })
+      .option('enable', {
+        describe: 'Enable server after installation',
+        type: 'boolean',
+        default: false
+      })
+      .option('force', {
+        describe: 'Force operation (skip confirmations)',
+        type: 'boolean',
+        default: false
+      })
+      .option('keep-package', {
+        describe: 'Keep npm package when uninstalling',
+        type: 'boolean',
+        default: false
+      })
+      .option('official', {
+        describe: 'Show only official @modelcontextprotocol servers',
+        type: 'boolean',
+        default: false
+      })
+      .option('category', {
+        describe: 'Filter by category',
+        type: 'string'
+      })
       .example('autopm mcp list', 'List all available MCP servers')
+      .example('autopm mcp search filesystem', 'Search npm for MCP servers')
+      .example('autopm mcp browse --official', 'Browse official MCP servers')
+      .example('autopm mcp install @modelcontextprotocol/server-filesystem', 'Install MCP server from npm')
+      .example('autopm mcp install @upstash/context7-mcp --enable', 'Install and enable immediately')
+      .example('autopm mcp uninstall filesystem', 'Uninstall MCP server')
       .example('autopm mcp enable context7-docs', 'Enable context7 documentation server')
       .example('autopm mcp agents', 'List all agents using MCP')
       .example('autopm mcp agent react-frontend-engineer', 'Show MCP config for specific agent')
@@ -107,6 +137,35 @@ module.exports = {
           handler.info(argv.name || argv.server);
           break;
 
+        // Discovery and installation commands
+        case 'search':
+          if (!argv.name) {
+            console.error('❌ Please specify a search query: autopm mcp search <query>');
+            process.exit(1);
+          }
+          await handler.search(argv.name, argv);
+          break;
+
+        case 'browse':
+          await handler.browse(argv);
+          break;
+
+        case 'install':
+          if (!argv.name) {
+            console.error('❌ Please specify a package name: autopm mcp install <package>');
+            process.exit(1);
+          }
+          await handler.installFromNpm(argv.name, argv);
+          break;
+
+        case 'uninstall':
+          if (!argv.name && !argv.server) {
+            console.error('❌ Please specify a server name: autopm mcp uninstall <server-name>');
+            process.exit(1);
+          }
+          await handler.uninstallServer(argv.name || argv.server, argv);
+          break;
+
         // Agent analysis commands
         case 'agents':
           handler.mcpAgents(argv.byServer ? { groupBy: 'server' } : {});

package/package.json

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