MCP Plugins for OpenCode - Extend with 1200+ Servers

##What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI assistants like OpenCode to interact with external tools, databases, and services. MCP was developed by Anthropic and donated to the Linux Foundation in December 2025, with over 1,200 servers available in the ecosystem.

###Why Use MCP Servers?

Extended Capabilities: Query databases, manage files, automate browsers, and more
Standardized Integration: One protocol for all tools, no custom integrations needed
Security First: Sandboxed execution with explicit permissions
Growing Ecosystem: 1,200+ servers available from official and community sources

##Installing MCP Servers

###Configuration File

OpenCode uses a configuration file to manage MCP servers. Create or edit ~/.config/opencode/config.toml:

bash

[mcp]
enabled = true

[mcp.servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]

[mcp.servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_PERSONAL_ACCESS_TOKEN = "ghp_your_token_here" }

###Project-Level Configuration

For project-specific servers, create .opencode.json in your project root:

bash

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

##Official Reference Servers

These are maintained by the MCP team and are the most reliable options:

###Filesystem Server

Access and manage files in specified directories.

bash

[mcp.servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]

Capabilities:

Read, write, and edit files
Create and delete directories
Search files with glob patterns
Get file metadata and stats

###GitHub Server

Full GitHub API integration for repository management.

bash

[mcp.servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_PERSONAL_ACCESS_TOKEN = "ghp_xxx" }

Capabilities:

Create and manage repositories
Handle pull requests and issues
Manage branches and commits
Access GitHub search API

###Git Server

Local Git operations for version control.

bash

[mcp.servers.git]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-git"]

Capabilities:

Clone, pull, push operations
Branch management
Commit history and diffs
Status and staging

###PostgreSQL Server

Query and manage PostgreSQL databases.

bash

[mcp.servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost:5432/mydb"]

Capabilities:

Execute SQL queries
Schema introspection
Data manipulation (INSERT, UPDATE, DELETE)
Transaction support

###SQLite Server

Lightweight database operations for SQLite.

bash

[mcp.servers.sqlite]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-sqlite", "--db-path", "./data.db"]

Capabilities:

SQL query execution
Schema management
Database file operations
Read-only or read-write modes

###Memory Server

Persistent knowledge graph for context retention.

bash

[mcp.servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]

Capabilities:

Store and retrieve knowledge entities
Create relationships between concepts
Persistent memory across sessions
Graph-based querying

###Sequential Thinking Server

Enhanced reasoning with dynamic thought chains.

bash

[mcp.servers.sequential-thinking]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-sequential-thinking"]

Capabilities:

Multi-step reasoning chains
Hypothesis testing
Complex problem decomposition
Thought revision and refinement

###Fetch Server

HTTP request capabilities for web APIs.

bash

[mcp.servers.fetch]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-fetch"]

Capabilities:

GET, POST, PUT, DELETE requests
Custom headers and authentication
JSON and text response handling
URL content extraction

##Popular Community Servers

###Playwright MCP

Browser automation and testing with Microsoft Playwright.

bash

[mcp.servers.playwright]
command = "npx"
args = ["-y", "@anthropic/mcp-server-playwright"]

Use Cases:

End-to-end testing
Web scraping with JavaScript rendering
Screenshot capture
Form automation
Accessibility testing

###Brave Search Server

Web search integration using Brave Search API.

bash

[mcp.servers.brave-search]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-brave-search"]
env = { BRAVE_API_KEY = "your_api_key" }

Capabilities:

Web search queries
News search
Image search
Local search results

###Puppeteer Server

Chrome browser automation (alternative to Playwright).

bash

[mcp.servers.puppeteer]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-puppeteer"]

Capabilities:

Headless Chrome control
Page navigation and interaction
PDF generation
Performance profiling

##Database Servers

###Supabase MCP

Full Supabase platform integration.

bash

[mcp.servers.supabase]
command = "npx"
args = ["-y", "supabase-mcp-server"]
env = { SUPABASE_URL = "https://xxx.supabase.co", SUPABASE_KEY = "your_key" }

Features:

Database queries
Authentication management
Storage operations
Real-time subscriptions

###Neo4j MCP

Graph database operations for Neo4j.

bash

[mcp.servers.neo4j]
command = "npx"
args = ["-y", "@neo4j/mcp-neo4j"]
env = { NEO4J_URI = "bolt://localhost:7687", NEO4J_USER = "neo4j", NEO4J_PASSWORD = "password" }

Capabilities:

Cypher query execution
Node and relationship management
Graph traversal
Schema inspection

###ClickHouse MCP

Analytics database for ClickHouse.

bash

[mcp.servers.clickhouse]
command = "npx"
args = ["-y", "@clickhouse/mcp-server"]
env = { CLICKHOUSE_URL = "http://localhost:8123" }

Use Cases:

Analytical queries
Time-series data
Log analysis
OLAP operations

##Productivity Servers

###Notion MCP

Notion workspace integration.

bash

[mcp.servers.notion]
command = "npx"
args = ["-y", "notion-mcp-server"]
env = { NOTION_API_KEY = "secret_xxx" }

Capabilities:

Read and update pages
Database queries
Create new content
Search workspace

###Linear MCP

Issue tracking with Linear.

bash

[mcp.servers.linear]
command = "npx"
args = ["-y", "@linear/mcp-server"]
env = { LINEAR_API_KEY = "lin_api_xxx" }

Features:

Create and update issues
Manage projects and cycles
Search issues
Workflow automation

###Slack MCP

Slack workspace integration.

bash

[mcp.servers.slack]
command = "npx"
args = ["-y", "slack-mcp-server"]
env = { SLACK_BOT_TOKEN = "xoxb-xxx" }

Capabilities:

Send messages
Read channel history
Manage channels
User lookups

##Cloud & DevOps Servers

###AWS MCP

Amazon Web Services integration.

bash

[mcp.servers.aws]
command = "npx"
args = ["-y", "aws-mcp-server"]
env = { AWS_ACCESS_KEY_ID = "xxx", AWS_SECRET_ACCESS_KEY = "xxx", AWS_REGION = "us-east-1" }

Supported Services:

S3 (storage)
Lambda (functions)
EC2 (compute)
DynamoDB (database)
CloudWatch (monitoring)

###Docker MCP

Container management for Docker.

bash

[mcp.servers.docker]
command = "npx"
args = ["-y", "docker-mcp-server"]

Capabilities:

List and manage containers
Build and push images
Network management
Volume operations

###Kubernetes MCP

Kubernetes cluster operations.

bash

[mcp.servers.kubernetes]
command = "npx"
args = ["-y", "kubernetes-mcp-server"]

Features:

Pod management
Deployment operations
Service configuration
Log retrieval

##Using Python Servers

Some MCP servers are written in Python and use uvx instead of npx:

bash

[mcp.servers.python-example]
command = "uvx"
args = ["mcp-server-example"]

Make sure you have uv installed:

bash

# Install uv (Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh

##Example: Full Development Setup

Here's a comprehensive configuration for full-stack development:

bash

[mcp]
enabled = true

# File system access for project
[mcp.servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]

# GitHub integration
[mcp.servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_PERSONAL_ACCESS_TOKEN = "${GITHUB_TOKEN}" }

# PostgreSQL database
[mcp.servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]

# Browser automation for testing
[mcp.servers.playwright]
command = "npx"
args = ["-y", "@anthropic/mcp-server-playwright"]

# Web search capability
[mcp.servers.brave-search]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-brave-search"]
env = { BRAVE_API_KEY = "${BRAVE_API_KEY}" }

# Knowledge memory
[mcp.servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]

##Security Best Practices

###1. Use Environment Variables

Never hardcode credentials in configuration files:

bash

# Add to ~/.bashrc or ~/.zshrc
export GITHUB_TOKEN="ghp_..."
export DATABASE_URL="postgresql://..."
export BRAVE_API_KEY="..."

Then reference them in config:

bash

env = { GITHUB_PERSONAL_ACCESS_TOKEN = "${GITHUB_TOKEN}" }

###2. Limit File System Access

Only grant access to necessary directories:

bash

# Good - specific project directory
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/myproject"]

# Avoid - entire home directory
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me"]

###3. Audit Server Permissions

Review what each server can access before installation:

bash

# Check npm package contents
npm info @modelcontextprotocol/server-github

# Review source code on GitHub
# https://github.com/modelcontextprotocol/servers

###4. Use Read-Only When Possible

For databases, use read-only connections when you don't need write access:

bash

[mcp.servers.postgres-readonly]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://readonly_user:pass@host/db"]

##Troubleshooting

###Server Not Starting

bash

Error: MCP server 'github' failed to start

Solutions:

Check npm/npx is installed and in PATH
Verify the package name is correct
Check environment variables are set
Try running the command manually to see errors

###Authentication Errors

bash

Error: GitHub API authentication failed

Solutions:

Verify token has required scopes (repo, read:org)
Check token hasn't expired
Ensure environment variable is exported
Try regenerating the token

###Connection Timeouts

bash

Error: Database connection timeout

Solutions:

Verify database server is running
Check firewall rules
Confirm connection string is correct
Test connection with psql or other client

##Resources

Official MCP Servers: github.com/modelcontextprotocol/servers
Awesome MCP Servers: github.com/wong2/awesome-mcp-servers
MCP Specification: spec.modelcontextprotocol.io
MCP Server Directory: mcp-awesome.com (1,200+ servers)