sbarrondocs

MCP Servers

Model Context Protocol (MCP) servers extend Claude Code with specialized tools and capabilities. Vision has access to 21 MCP servers providing browser automation, search, documentation, error tracking, and more.

Overview

Total Servers: 21 configured (5 active Cloudflare, 1 DigitalOcean, 15 Docker-based) Configuration: User scope (available across all projects) Config File: ~/.claude.json

Active Servers

Cloudflare MCP Servers

cloudflare-docs

  • Documentation search for all Cloudflare products
  • Workers, Pages, R2, D1, KV, AI, Zero Trust, CDN, DNS

cloudflare-bindings

  • Workers storage, AI, and compute primitives
  • R2, KV, D1, Durable Objects, Queues

cloudflare-observability

  • Logs and analytics debugging for Workers
  • Query logs, metrics, traces

cloudflare-browser

  • Screenshots and markdown conversion
  • Browser automation via Cloudflare

DigitalOcean MCP Server

Complete DigitalOcean API access:

  • Droplets: Create, manage, power control
  • Networking: DNS, domains, firewalls, load balancers
  • Accounts: Billing, SSH keys, team management
  • Insights: Monitoring, alerts, uptime checks

Personal Server: 157.245.211.127 Work Production: 137.184.104.104

Docker-Based MCP Servers

Browser Automation

playwright (1.67GB)

  • Full Playwright browser automation
  • Chrome, Firefox, WebKit support
  • Screenshots, PDFs, interactions

puppeteer (1.91GB)

  • Puppeteer Chrome automation
  • Headless browsing, testing
  • Page interactions, screenshots

desktop-commander

  • macOS filesystem and app control
  • Full root access via Docker volume mount
  • Directory operations, file management

Search & Research

duckduckgo

  • Web search via DuckDuckGo
  • Privacy-focused results

wikipedia

  • Wikipedia article search and retrieval
  • Knowledge base queries

youtube-transcript

  • YouTube video transcript extraction
  • Caption and subtitle access

Development Tools

sqlite

  • SQLite database operations
  • Schema inspection, queries

fetch

  • HTTP/HTTPS requests
  • API testing, web scraping

ast-grep

  • Code structure search
  • AST-based pattern matching

github (via docker-mcp-gateway)

  • Repository operations
  • Issue/PR management
  • Code search

Documentation

dockerhub

  • Docker Hub image search
  • Container documentation

jetbrains

  • JetBrains IDE documentation
  • IntelliJ, PyCharm, WebStorm

atlas-docs

  • MongoDB Atlas documentation
  • Database guides

Communication & Monitoring

slack

  • #qc channel direct access
  • Message posting, reading
  • Team: T09L15F1KDG

flare (HTTP)

  • Error tracking integration
  • Production error monitoring
  • Check FIRST for production errors

AI & Media

hf-spaces (HuggingFace)

  • shuttle-3.1-aesthetic (image generation)
  • whisper-large-v3-turbo (audio transcription)
  • QVQ-72B-preview (vision model)
  • OmniParser (document parsing)

Configuration

Add MCP Server

# User scope (available everywhere)
claude mcp add --scope user <name> docker -- run -i --rm <image>:latest

# Project scope (current project only)
claude mcp add <name> docker -- run -i --rm <image>:latest

List Servers

claude mcp list

Remove Server

claude mcp remove --scope user <name>

Verify Connection

# Check server health
claude mcp list

# Look for:
# ✓ Connected - Server operational
# ✗ Failed to connect - Check Docker or authentication

Docker MCP Gateway

Special gateway server that bundles multiple MCP servers with secret management:

Included Servers:

  • GitHub (with configured token)
  • Toolkit utilities

Benefits:

  • Single Docker container
  • Centralized secret management
  • Multiple tools in one server

Usage:

claude mcp add --scope user docker-mcp-gateway docker -- mcp gateway run

Common Workflows

Browser Testing

# Use playwright for GUI testing
# ALWAYS use Chrome (not Safari)
# Take screenshots for verification

Error Tracking

# Check Flare FIRST for production errors
~/.claude/check_flare_errors.sh

# Provides comprehensive error context before code diving

Server Management

# DigitalOcean droplet operations
# Create, power on/off, reboot, snapshot
# DNS and domain management

Documentation Search

# Cloudflare docs for Workers/Pages
# JetBrains docs for IDE questions
# Atlas docs for MongoDB

Troubleshooting

Docker Servers Offline

Check Docker Status:

docker info

Start Docker:

open -a Docker

Verify Servers:

claude mcp list

Authentication Errors

GitHub: Token configured in docker-mcp-gateway DigitalOcean: API token in user-level config Cloudflare: API token in user-level config

Connection Issues

Desktop Commander Volume Mount:

# Requires -v /Users/shanebarron:/Users/shanebarron for filesystem access
# Configured in ~/.claude.json

Slack Token:

# Bot token: xoxb-9681185053458-9681719947746-jZIp7opVj7CxdbtBBQtWcDBS
# Team: T09L15F1KDG
# Channel: #qc (C09LW0QNB6U)

Server Requirements

Docker-Based Servers

  • Docker Desktop running
  • Sufficient disk space (some images >1GB)
  • Internet connection for first pull

NPX-Based Servers

  • Node.js installed
  • Internet connection
  • Valid API tokens (if required)

HTTP-Based Servers

  • Internet connection
  • Valid API endpoints

Best Practices

  1. Use specialized tools instead of bash commands

    • Browser: playwright/puppeteer (not curl)
    • Files: Read/Write/Edit tools (not cat/sed)
    • Search: Grep tool (not grep command)

  2. Check Flare first for production errors

    • Comprehensive error context
    • Stack traces, user data, environment
    • Faster than manual debugging

  3. User scope for common servers

    • Available across all projects
    • No per-project reconfiguration
    • Consistent toolset

  4. Verify after adding

    • Run claude mcp list to confirm
    • Check for "✓ Connected" status
    • Test with simple operation

Status: 5/21 Connected (Docker offline) Last Verified: 2025-10-17

Was this page helpful?