claude-autopm 1.15.0 → 1.15.2

package/autopm/.claude/agents/languages/python-backend-expert.md

@@ -13,10 +13,10 @@ Before implementing any Python backend solution, access live documentation throu
 - **Async**: asyncio, aiohttp, uvloop, concurrent.futures
 
 **Documentation Queries:**
-- `mcp://context7-docs/python/fastapi` - FastAPI framework
-- `mcp://context7-docs/python/sqlalchemy` - SQLAlchemy ORM
-- `mcp://context7-docs/python/django` - Django framework
-- `mcp://context7-docs/python/pytest` - pytest testing
+- `mcp://context7/python/fastapi` - FastAPI framework
+- `mcp://context7/python/sqlalchemy` - SQLAlchemy ORM
+- `mcp://context7/python/django` - Django framework
+- `mcp://context7/python/pytest` - pytest testing
 
 ## Test-Driven Development (TDD) Methodology
 

package/autopm/.claude/agents/testing/frontend-testing-engineer.md

@@ -27,10 +27,10 @@ Before implementing any testing solution, access live documentation through cont
 - **Best Practices**: Testing patterns, mocking strategies, assertion libraries
 
 **Documentation Queries:**
-- `mcp://context7-docs/javascript/jest` - Jest testing framework
-- `mcp://context7-docs/react/testing-library` - React Testing Library
-- `mcp://context7-docs/vue/test-utils` - Vue Test Utils
-- `mcp://context7-docs/angular/testing` - Angular testing utilities
+- `mcp://context7/javascript/jest` - Jest testing framework
+- `mcp://context7/react/testing-library` - React Testing Library
+- `mcp://context7/vue/test-utils` - Vue Test Utils
+- `mcp://context7/angular/testing` - Angular testing utilities
 
 **Core Expertise:**
 

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,28 +1,11 @@
 {
   "mcpServers": {
-    "context7-docs": {
+    "context7": {
       "command": "npx",
-      "args": ["@upstash/context7-mcp"],
+      "args": ["-y", "@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"
+        "DEFAULT_MINIMUM_TOKENS": "${DEFAULT_MINIMUM_TOKENS:-10000}"
+      }
     },
     "playwright-mcp": {
       "command": "npx",
@@ -37,7 +20,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 +29,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 +38,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 +47,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 +56,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 +65,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 +74,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,10 @@ This document provides guidance on MCP (Model Context Protocol) server managemen
 
 Example MCP server configurations are available in `.claude/examples/mcp/`:
 
-### context7-docs
-**Description**: Context7 documentation server for accessing technical documentation
-**Use Cases**: API documentation, framework guides, technical references
-**Example**: `.claude/examples/mcp/context7-docs.md`
-
-### context7-codebase
-**Description**: Context7 codebase server for project code analysis
-**Use Cases**: Code navigation, project analysis, dependency tracking
-**Example**: `.claude/examples/mcp/context7-codebase.md`
+### context7
+**Description**: Context7 MCP server - up-to-date documentation database for any library or framework
+**Use Cases**: API documentation, framework guides, technical references, library lookups
+**Example**: `.claude/examples/mcp/context7.md`
 
 ### playwright-mcp
 **Description**: Playwright MCP server for browser automation and testing
@@ -90,7 +85,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 +98,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 +114,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 +204,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/autopm.js

@@ -257,7 +257,7 @@ function main() {
 🔌 MCP (Model Context Protocol) Management:
    # List and manage MCP servers
    autopm mcp list                  # List all available MCP servers
-   autopm mcp enable context7-docs  # Enable documentation server
+   autopm mcp enable context7  # Enable documentation server
    autopm mcp sync                  # Sync configuration to .claude/mcp-servers.json
 
    # Agent Analysis
@@ -269,7 +269,7 @@ function main() {
    # Configuration & Diagnostics
    autopm mcp setup                 # Interactive API key setup
    autopm mcp diagnose              # Run comprehensive diagnostics
-   autopm mcp test context7-docs    # Test MCP server connection
+   autopm mcp test context7    # Test MCP server connection
    autopm mcp status                # Show all MCP servers status
 
 🔑 Token Setup:

package/bin/commands/mcp.js

@@ -70,14 +70,14 @@ module.exports = {
       .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 enable context7', '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')
       .example('autopm mcp usage', 'Show MCP usage statistics')
       .example('autopm mcp setup', 'Interactive API key setup')
       .example('autopm mcp check', 'Quick MCP configuration check')
       .example('autopm mcp diagnose', 'Run MCP diagnostics')
-      .example('autopm mcp test context7-docs', 'Test MCP server connection')
+      .example('autopm mcp test context7', 'Test MCP server connection')
       .example('autopm mcp tree', 'Show agent-MCP dependency tree')
       .example('autopm mcp status', 'Show MCP servers status');
   },

package/package.json

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

package/scripts/mcp-handler.js

@@ -1594,8 +1594,7 @@ ${pkg.repository?.url ? `- Repository: ${pkg.repository.url}` : ''}
    */
   _getCredentialInfo(serverName) {
     const info = {
-      'context7-docs': '→ Sign up at https://context7.com and get API key from dashboard',
-      'context7-codebase': '→ Same credentials as context7-docs',
+      'context7': '→ Sign up at https://context7.com and get API key from dashboard',
       'github-mcp': '→ Generate token at https://github.com/settings/tokens',
       'playwright-mcp': '→ No credentials needed - uses local Playwright installation'
     };