[PR #3570] feat: Add MCP Management Commands and Agent Documentation #10691

Closed
opened 2026-02-16 18:15:25 -05:00 by yindo · 0 comments
Owner

Original Pull Request: https://github.com/anomalyco/opencode/pull/3570

State: closed
Merged: No


Summary

This PR adds comprehensive MCP (Model Context Protocol) management commands to opencode, enabling users to easily list, connect, and manage MCP servers from the CLI. It also includes extensive documentation for all available agents and their capabilities.

Features Added

🚀 New MCP Management Commands

  • opencode mcp list - List all configured MCP servers with their status
  • opencode mcp connect <server> - Connect to a specific MCP server
  • opencode mcp disconnect <server> - Disconnect from a specific MCP server
  • opencode mcp status - Show connection status of all MCP servers

📚 Comprehensive Agent Documentation

Added detailed documentation for 50+ specialized agents including:

Development & Engineering

  • Frontend Development: frontend-developer, nextjs-expert, react-developer, svelte-pro, vue-expert
  • Backend Development: backend-architect, fastapi-pro, django-pro, java-pro, golang-pro, rust-pro, python-pro
  • Mobile Development: mobile-developer, ios-developer, flutter-expert, react-native
  • DevOps & Infrastructure: devops-operations-specialist, deployment-engineer, kubernetes-architect, terraform-specialist

AI & Machine Learning

  • AI Engineering: ai-engineer, ml-engineer, mlops-engineer, ai-integration-expert
  • Data Science: data-scientist, data-engineer, analytics-engineer

Security & Compliance

  • Security: security-scanner, security-auditor, backend-security-coder, frontend-security-coder, mobile-security-coder
  • Compliance: compliance-expert

Database & Performance

  • Database: database-expert, database-optimizer, database-admin, sql-pro
  • Performance: performance-engineer, load-tester, quality-testing-performance-tester

Product & Design

  • Product Management: product-manager, business-analyst
  • Design & UX: ui-ux-designer, design-systems-architect, ux-optimizer, accessibility-pro

Content & SEO

  • Content Marketing: content-marketer, seo-content-writer, seo-content-planner, seo-authority-builder
  • SEO Optimization: seo-meta-optimizer, seo-keyword-strategist, seo-structure-architect, seo-cannibalization-detector, seo-content-auditor, seo-content-refresher, seo-snippet-hunter

Specialized Platforms

  • Cloud: cloud-architect, hybrid-cloud-architect
  • Blockchain/Web3: blockchain-developer, web3-architect
  • E-commerce: ecommerce-specialist, payment-integration
  • Gaming: unity-developer, minecraft-bukkit-pro
  • IoT: iot-device-engineer, iot-security-specialist

Tools & Integrations

  • Git/GitHub: github-operations-specialist
  • Monitoring: monitoring-expert, observability-engineer, error-monitoring-specialist
  • Testing: test-automator, test-generator, accessibility-tester
  • Documentation: docs-architect, documentation-specialist, api-documenter, reference-builder, tutorial-engineer

Management & Architecture

  • Architecture: system-architect, architect-review, agent-architect
  • Project Management: incident-responder, operations-incident-commander, release-manager
  • Developer Experience: dx-optimizer, onboarding-experience-designer

Usage Examples

MCP Server Management

# List all configured MCP servers
opencode mcp list

# Connect to a specific MCP server
opencode mcp connect filesystem

# Check connection status
opencode mcp status

# Disconnect from a server
opencode mcp disconnect filesystem

Agent Usage

# Use a specialized agent for frontend development
opencode --agent frontend-developer "Create a React component with TypeScript"

# Use an agent for security review
opencode --agent security-scanner "Review this code for security vulnerabilities"

# Use an agent for documentation
opencode --agent docs-architect "Create comprehensive API documentation"

Configuration

MCP servers can be configured in your opencode configuration file. The commands support:

  • Multiple server configurations
  • Connection status tracking
  • Error handling and validation
  • Detailed status reporting

Documentation Structure

Each agent includes:

  • Description: Clear explanation of what the agent does
  • Use Cases: Specific scenarios where the agent excels
  • Example Commands: Practical usage examples
  • Related Agents: Cross-references to similar or complementary agents

Benefits

  1. Improved Developer Experience: Easy MCP server management from CLI
  2. Better Agent Discovery: Comprehensive documentation helps users find the right agent
  3. Enhanced Productivity: Specialized agents for specific tasks
  4. Consistent Interface: Standardized command structure across all agents
  5. Better Error Handling: Robust error handling and user feedback

Testing

  • All MCP commands tested with various server configurations
  • Agent documentation verified for accuracy and completeness
  • Error handling tested for edge cases
  • Integration tested with existing opencode workflows

This update significantly enhances opencode's capabilities by providing both powerful MCP management tools and comprehensive agent documentation, making it easier for users to leverage the full potential of specialized AI agents.

**Original Pull Request:** https://github.com/anomalyco/opencode/pull/3570 **State:** closed **Merged:** No --- ## Summary This PR adds comprehensive MCP (Model Context Protocol) management commands to opencode, enabling users to easily list, connect, and manage MCP servers from the CLI. It also includes extensive documentation for all available agents and their capabilities. ## Features Added ### 🚀 New MCP Management Commands - **`opencode mcp list`** - List all configured MCP servers with their status - **`opencode mcp connect <server>`** - Connect to a specific MCP server - **`opencode mcp disconnect <server>`** - Disconnect from a specific MCP server - **`opencode mcp status`** - Show connection status of all MCP servers ### 📚 Comprehensive Agent Documentation Added detailed documentation for **50+ specialized agents** including: #### **Development & Engineering** - **Frontend Development**: `frontend-developer`, `nextjs-expert`, `react-developer`, `svelte-pro`, `vue-expert` - **Backend Development**: `backend-architect`, `fastapi-pro`, `django-pro`, `java-pro`, `golang-pro`, `rust-pro`, `python-pro` - **Mobile Development**: `mobile-developer`, `ios-developer`, `flutter-expert`, `react-native` - **DevOps & Infrastructure**: `devops-operations-specialist`, `deployment-engineer`, `kubernetes-architect`, `terraform-specialist` #### **AI & Machine Learning** - **AI Engineering**: `ai-engineer`, `ml-engineer`, `mlops-engineer`, `ai-integration-expert` - **Data Science**: `data-scientist`, `data-engineer`, `analytics-engineer` #### **Security & Compliance** - **Security**: `security-scanner`, `security-auditor`, `backend-security-coder`, `frontend-security-coder`, `mobile-security-coder` - **Compliance**: `compliance-expert` #### **Database & Performance** - **Database**: `database-expert`, `database-optimizer`, `database-admin`, `sql-pro` - **Performance**: `performance-engineer`, `load-tester`, `quality-testing-performance-tester` #### **Product & Design** - **Product Management**: `product-manager`, `business-analyst` - **Design & UX**: `ui-ux-designer`, `design-systems-architect`, `ux-optimizer`, `accessibility-pro` #### **Content & SEO** - **Content Marketing**: `content-marketer`, `seo-content-writer`, `seo-content-planner`, `seo-authority-builder` - **SEO Optimization**: `seo-meta-optimizer`, `seo-keyword-strategist`, `seo-structure-architect`, `seo-cannibalization-detector`, `seo-content-auditor`, `seo-content-refresher`, `seo-snippet-hunter` #### **Specialized Platforms** - **Cloud**: `cloud-architect`, `hybrid-cloud-architect` - **Blockchain/Web3**: `blockchain-developer`, `web3-architect` - **E-commerce**: `ecommerce-specialist`, `payment-integration` - **Gaming**: `unity-developer`, `minecraft-bukkit-pro` - **IoT**: `iot-device-engineer`, `iot-security-specialist` #### **Tools & Integrations** - **Git/GitHub**: `github-operations-specialist` - **Monitoring**: `monitoring-expert`, `observability-engineer`, `error-monitoring-specialist` - **Testing**: `test-automator`, `test-generator`, `accessibility-tester` - **Documentation**: `docs-architect`, `documentation-specialist`, `api-documenter`, `reference-builder`, `tutorial-engineer` #### **Management & Architecture** - **Architecture**: `system-architect`, `architect-review`, `agent-architect` - **Project Management**: `incident-responder`, `operations-incident-commander`, `release-manager` - **Developer Experience**: `dx-optimizer`, `onboarding-experience-designer` ## Usage Examples ### MCP Server Management ```bash # List all configured MCP servers opencode mcp list # Connect to a specific MCP server opencode mcp connect filesystem # Check connection status opencode mcp status # Disconnect from a server opencode mcp disconnect filesystem ``` ### Agent Usage ```bash # Use a specialized agent for frontend development opencode --agent frontend-developer "Create a React component with TypeScript" # Use an agent for security review opencode --agent security-scanner "Review this code for security vulnerabilities" # Use an agent for documentation opencode --agent docs-architect "Create comprehensive API documentation" ``` ## Configuration MCP servers can be configured in your opencode configuration file. The commands support: - Multiple server configurations - Connection status tracking - Error handling and validation - Detailed status reporting ## Documentation Structure Each agent includes: - **Description**: Clear explanation of what the agent does - **Use Cases**: Specific scenarios where the agent excels - **Example Commands**: Practical usage examples - **Related Agents**: Cross-references to similar or complementary agents ## Benefits 1. **Improved Developer Experience**: Easy MCP server management from CLI 2. **Better Agent Discovery**: Comprehensive documentation helps users find the right agent 3. **Enhanced Productivity**: Specialized agents for specific tasks 4. **Consistent Interface**: Standardized command structure across all agents 5. **Better Error Handling**: Robust error handling and user feedback ## Testing - All MCP commands tested with various server configurations - Agent documentation verified for accuracy and completeness - Error handling tested for edge cases - Integration tested with existing opencode workflows This update significantly enhances opencode's capabilities by providing both powerful MCP management tools and comprehensive agent documentation, making it easier for users to leverage the full potential of specialized AI agents.
yindo added the pull-request label 2026-02-16 18:15:25 -05:00
yindo closed this issue 2026-02-16 18:15:25 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#10691