MCP Sample Configurations¶
This directory contains example configuration files for integrating Model Context Protocol (MCP) servers with AI development tools.
Available Samples¶
Docker Desktop GitHub MCP¶
File: docker-desktop-github-mcp.json
Configuration for running GitHub MCP server through Docker Desktop integration.
Features: - GitHub repository access - Issue and PR management - Code search capabilities
Docker MCP Server¶
File: sample-docker-mcp.json
General Docker-based MCP server configuration template.
Use Cases: - Running MCP servers in containers - Isolated server environments - Cross-platform compatibility
NPX MCP Server¶
File: sample-npx-mcp.json
Configuration for running MCP servers via NPX (Node Package Runner).
Use Cases: - JavaScript/TypeScript MCP servers - Quick server deployment - No installation required
Usage¶
- Choose a sample - Select the configuration that matches your use case
- Copy to your project - Copy the JSON file to your tool's config directory
- Customize - Update server URLs, credentials, and options
- Test - Verify the server connection works
Integration Guides¶
For detailed integration instructions, see:
- MCP Configuration Guide - Comprehensive setup guide
- MCP Overview - Concepts and architecture
- OpenCode MCP Integration - OpenCode-specific setup
Configuration Format¶
All sample files follow this general structure:
{
"mcpServers": {
"server-name": {
"command": "docker|npx|path-to-executable",
"args": ["arg1", "arg2"],
"env": {
"ENV_VAR": "value"
}
}
}
}
Environment Variables¶
Many MCP servers require API keys or credentials. Store these securely:
- Use environment variables for sensitive data
- Never commit credentials to version control
- Reference env vars in config:
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
Next Steps¶
- Review MCP Overview for concepts
- Follow Configuration Guide for setup
- Explore OpenCode Integration for usage examples