MCP_SERVER_CONFIG.md

Model Context Protocol (MCP) Servers Configuration Guide

Common Server Setup

All MCP servers follow a basic configuration pattern:

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server({
  name: "server-name",
  version: "version",
}, {
  capabilities: {
    tools: {}
  }
});

async function runServer() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
}

Server-Specific Configurations

Filesystem Server

{
  name: "filesystem-mcp-server",
  version: "0.5.1",
  config: {
    // Directories the server is allowed to access (required)
    allowedDirectories: string[],
    // Maximum file size for read operations (optional)
    maxFileSize: number,
    // File patterns to ignore (optional)
    ignorePatterns: string[]
  }
}

Fetch Server

{
  name: "fetch-mcp-server",
  version: "0.5.1",
  config: {
    // Maximum content size to fetch (optional)
    maxContentSize: number,
    // Timeout in milliseconds (optional)
    timeout: number,
    // User agent string (optional)
    userAgent: string,
    // Follow redirects (optional)
    followRedirects: boolean
  }
}

Brave Search Server

{
  name: "brave-search-mcp-server",
  version: "0.5.1",
  config: {
    // Required environment variables
    env: {
      BRAVE_API_KEY: string
    },
    // Rate limits
    rateLimit: {
      perSecond: 1,
      perMonth: 15000
    },
    // Search options
    search: {
      defaultCount: number,  // Default number of results
      maxCount: 20,         // Maximum results per request
      maxOffset: 9          // Maximum page offset
    }
  }
}

GitHub Server

{
  name: "github-mcp-server",
  version: "0.5.1",
  config: {
    // Required environment variables
    env: {
      GITHUB_PERSONAL_ACCESS_TOKEN: string
    },
    // API configuration
    api: {
      baseUrl: "https://api.github.com",
      accept: "application/vnd.github.v3+json",
      userAgent: "github-mcp-server"
    },
    // Repository defaults
    defaults: {
      visibility: "private" | "public",
      autoInit: boolean,
      gitignoreTemplate: string,
      licenseTemplate: string
    }
  }
}

GitLab Server

{
  name: "gitlab-mcp-server",
  version: "0.5.1",
  config: {
    // Required environment variables
    env: {
      GITLAB_PERSONAL_ACCESS_TOKEN: string,
      GITLAB_API_URL: string // Optional, defaults to https://gitlab.com/api/v4
    },
    // Repository defaults
    defaults: {
      visibility: "private" | "internal" | "public",
      initializeWithReadme: boolean,
      defaultBranch: string
    },
    // Pagination settings
    pagination: {
      defaultPerPage: 20,
      maxPerPage: 100
    }
  }
}

SQLite Server

{
  "name": "sqlite-mcp-server",
  "version": "0.5.1",
  "config": {
    # Required command line arguments
    "args": {
      "--db-path": "Path to SQLite database file (default: ./sqlite_mcp_server.db)"
    },
    # Optional settings
    "settings": {
      "max_rows": int,          # Maximum rows to return in query results
      "timeout": int,           # Query timeout in seconds
      "journal_mode": string,   # SQLite journal mode
      "synchronous": string,    # Synchronous mode
      "temp_store": string      # Temporary storage location
    }
  }
}

PostgreSQL Server

{
  name: "postgres-mcp-server",
  version: "0.5.1",
  config: {
    // Required environment variables
    env: {
      PGHOST: string,
      PGPORT: string,
      PGDATABASE: string,
      PGUSER: string,
      PGPASSWORD: string,
      PGSSLMODE: string    // Optional: disable, allow, prefer, require, verify-ca, verify-full
    },
    // Optional connection pool settings
    pool: {
      max: number,         // Maximum number of clients
      idleTimeoutMillis: number,
      connectionTimeoutMillis: number,
      allowExitOnIdle: boolean
    },
    // Query settings
    query: {
      maxRows: number,     // Maximum rows to return
      timeout: number,     // Query timeout in milliseconds
      readOnly: boolean    // Force read-only mode
    }
  }
}

Google Drive Server

{
  name: "gdrive-mcp-server",
  version: "0.5.1",
  config: {
    // Required credentials file
    credentialsPath: ".gdrive-server-credentials.json",
    // Optional settings
    settings: {
      pageSize: number,    // Default number of items per page (max 100)
      fields: string[],    // Default fields to return
      includeTeamDrives: boolean,
      supportsAllDrives: boolean,
      corpora: "user" | "drive" | "allDrives"
    },
    // Cache settings
    cache: {
      enabled: boolean,
      maxAge: number      // Cache TTL in seconds
    }
  }
}

Puppeteer Server

{
  name: "puppeteer-mcp-server",
  version: "0.5.1",
  config: {
    // Browser launch options
    browser: {
      headless: boolean,
      defaultViewport: {
        width: number,
        height: number
      },
      args: string[],     // Additional browser arguments
      ignoreHTTPSErrors: boolean,
      timeout: number     // Browser launch timeout
    },
    // Screenshot defaults
    screenshot: {
      defaultWidth: 800,
      defaultHeight: 600,
      quality: number,    // JPEG quality (0-100)
      fullPage: boolean,
      type: "jpeg" | "png"
    },
    // Navigation settings
    navigation: {
      waitUntil: "load" | "domcontentloaded" | "networkidle0" | "networkidle2",
      timeout: number
    }
  }
}

Slack Server

{
  name: "slack-mcp-server",
  version: "0.5.1",
  config: {
    // Required environment variables
    env: {
      SLACK_BOT_TOKEN: string,
      SLACK_TEAM_ID: string
    },
    // Optional settings
    settings: {
      defaultLimit: number,     // Default number of items per page (max 1000)
      retryOnRateLimit: boolean,// Whether to retry on rate limit errors
      retryCount: number,       // Maximum number of retries
      includeLabels: boolean,   // Include labels in user profiles
      excludeArchived: boolean  // Exclude archived channels
    }
  }
}

Environment Variables Summary

Server	Required Variables	Optional Variables
Brave Search	BRAVE_API_KEY	None
GitHub	GITHUB_PERSONAL_ACCESS_TOKEN	None
GitLab	GITLAB_PERSONAL_ACCESS_TOKEN	GITLAB_API_URL
PostgreSQL	PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD	PGSSLMODE
Google Drive	None (uses credentials file)	None
Slack	SLACK_BOT_TOKEN, SLACK_TEAM_ID	None

Command Line Arguments Summary

Server	Required Arguments	Optional Arguments
Filesystem	allowedDirectories	None
SQLite	--db-path	None
Git	--repository	-v, --verbose
Others	None	None

Rate Limits and Quotas

Server	Limits
Brave Search	1 request/second, 15000 requests/month
GitHub	Depends on API token type
GitLab	Depends on API token type
Slack	Depends on subscription type
Google Drive	Depends on quota settings in Google Cloud Console

Security Notes

1. API Keys and Tokens: Never commit API keys or tokens to version control. Use environment variables or secure configuration files.
2. File Access: The Filesystem server should be configured to access only necessary directories.
3. Database Access: PostgreSQL and SQLite servers should use read-only users when possible.
4. SSL/TLS: Enable SSL/TLS for database connections in production environments.