Skip to content

Instantly share code, notes, and snippets.

@gitgrooves

gitgrooves/.md

Forked from feveromo/Claude MCP Windows.md
Created November 27, 2024 12:12
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save gitgrooves/f57903e85aabdcfc43af74673d21ef45 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save gitgrooves/f57903e85aabdcfc43af74673d21ef45 to your computer and use it in GitHub Desktop.
Download ZIP

Revisions

  1. @feveromo feveromo revised this gist Nov 26, 2024. 1 changed file with 68 additions and 72 deletions.
    140 changes: 68 additions & 72 deletions .md
    View file
    Original file line number Diff line number Diff line change
    @@ -1,25 +1,6 @@
    # Setting Up MCP Servers on Windows
    A step-by-step guide to setting up Model Context Protocol (MCP) servers for Claude Desktop on Windows.

    ## Overview
    MCP servers provide Large Language Models (LLMs) with secure, controlled access to various tools and data sources. Available servers include:

    ### Node.js-based Servers
    - **Memory** - Knowledge graph-based persistent memory system
    - **Filesystem** - Secure file operations with access controls
    - **GitHub** - Repository management and GitHub API integration
    - **Google Drive** - File access and search capabilities
    - **Slack** - Channel management and messaging
    - **Puppeteer** - Browser automation and web scraping
    - **Brave Search** - Web and local search integration
    - **Google Maps** - Location services and directions

    ### Python-based Servers
    - **SQLite** - Local database operations
    - **Git** - Local repository management
    - **Fetch** - Web content fetching and conversion
    - **PostgreSQL** - Read-only database access

    ## Prerequisites
    1. Install Node.js (v18.x or later)
    - Download from: https://nodejs.org/
    @@ -29,7 +10,7 @@ MCP servers provide Large Language Models (LLMs) with secure, controlled access
    npm --version
    ```
    2. Install Python 3.10 or later (required for Python-based servers)
    2. Install Python 3.10 or later (for Python-based servers)
    - Download from: https://www.python.org/downloads/
    - Make sure to check "Add Python to PATH" during installation
    @@ -40,100 +21,115 @@ Open PowerShell as administrator and run:
    ```powershell
    # For Python-based servers
    npm install -g uv
    # Node.js package manager (npm) comes with Node.js installation
    ```

    ### 2. Install MCP Servers

    #### For Node.js-based servers:
    ```powershell
    # General format
    npm install -g @modelcontextprotocol/server-<name>
    # Examples
    # Install servers globally
    npm install -g @modelcontextprotocol/server-memory
    npm install -g @modelcontextprotocol/server-github
    npm install -g @modelcontextprotocol/server-everything
    npm install -g @modelcontextprotocol/server-brave-search
    # ... other servers you want to install
    ```

    #### For Python-based servers:
    ```powershell
    # Using uvx (recommended)
    uvx mcp-server-<name>
    # Alternative using pip
    pip install mcp-server-<name>
    # Using uvx
    uvx mcp-server-sqlite
    ```

    ### 3. Configure Claude Desktop

    1. Open File Explorer and navigate to:
    - `%AppData%\Claude Desktop\`
    - Create `claude_desktop_config.json` if it doesn't exist
    1. Navigate to: `%AppData%\Claude Desktop\`
    2. Create or edit `claude_desktop_config.json`
    3. Use this configuration structure:

    2. Example configuration structure:
    ```json
    {
    "globalShortcut": "Ctrl+Space",
    "mcpServers": {
    "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\path\\to\\files"]
    "sqlite": {
    "command": "uvx",
    "args": ["mcp-server-sqlite", "--db-path", "C:\\Users\\YourUsername\\test.db"]
    },
    "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "memory": {
    "command": "node",
    "args": ["C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-memory\\dist\\index.js"],
    "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
    "DEBUG": "*"
    }
    },
    "postgres": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    "everything": {
    "command": "node",
    "args": ["C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-everything\\dist\\index.js"],
    "env": {
    "DEBUG": "*"
    }
    },
    "git": {
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "C:\\path\\to\\repo"]
    "brave-search": {
    "command": "node",
    "args": ["C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-brave-search\\dist\\index.js"],
    "env": {
    "BRAVE_API_KEY": "YOUR_API_KEY_HERE",
    "DEBUG": "*"
    }
    }
    }
    }
    ```

    **Important:**
    - Replace `YourUsername` with your Windows username
    - Replace `YOUR_API_KEY_HERE` with your actual API key for services that require it
    - Use double backslashes (\\) in all Windows paths
    - Point to the `dist/index.js` file in the npm modules directory

    ## Server-Specific Setup

    ### SQLite Server
    - Only requires the basic setup shown above
    - Customize the `--db-path` argument to your preferred location

    ### Memory Server
    - No additional setup required
    - Debug logging enabled by default

    ### Everything Server
    - No additional setup required
    - Debug logging enabled by default

    ### Brave Search Server
    1. Get API key from https://brave.com/search/api/
    2. Add it to the config's env section as shown above

    ## Verification & Troubleshooting

    ### Verify Installations
    ```powershell
    # Check Node.js packages
    # List installed packages
    npm list -g --depth=0
    # Test servers directly
    # Test individual servers
    npx @modelcontextprotocol/server-memory
    npx @modelcontextprotocol/server-brave-search
    uvx mcp-server-sqlite
    ```

    ### Common Issues
    1. "Command not found"
    - Verify Node.js/Python are in PATH
    - Try running PowerShell as administrator

    2. "Could not attach to MCP server"
    - Check config file paths are correct
    - Use double backslashes (\\) in Windows paths
    - Verify server package is installed
    1. "Could not attach to MCP server"
    - Verify the paths in config match your system
    - Make sure all packages are installed globally (-g flag)
    - Check that dist/index.js exists in the specified paths

    3. Server not showing in Claude
    2. Server not showing in Claude
    - Restart Claude Desktop
    - Check config file location
    - Enable DEBUG env variable in config
    - Verify JSON syntax in config file
    - Check file paths are correct

    ## Tips
    - Always use double backslashes (\\) for Windows paths in JSON
    - Run installation commands as administrator
    - Keep package managers and servers updated
    - Check server documentation for specific requirements
    - Visit [modelcontextprotocol.io](https://modelcontextprotocol.io) for detailed documentation

    ## Additional Resources
    - [GitHub Repository](https://github.com/modelcontextprotocol/servers)
    - [Contributing Guidelines](https://github.com/modelcontextprotocol/servers/blob/main/CONTRIBUTING.md)
    - [Security Policy](https://github.com/modelcontextprotocol/servers/blob/main/SECURITY.md)
    - Always use global installations (`npm install -g`)
    - Use full paths to `dist/index.js` in the config
    - Keep DEBUG env variable for troubleshooting
    - Restart Claude Desktop after config changes
  2. @feveromo feveromo revised this gist Nov 26, 2024. 1 changed file with 45 additions and 38 deletions.
    83 changes: 45 additions & 38 deletions .md
    View file
    Original file line number Diff line number Diff line change
    @@ -1,6 +1,25 @@
    # Setting Up MCP Servers on Windows
    A step-by-step guide to setting up Model Context Protocol (MCP) servers for Claude Desktop on Windows.

    ## Overview
    MCP servers provide Large Language Models (LLMs) with secure, controlled access to various tools and data sources. Available servers include:

    ### Node.js-based Servers
    - **Memory** - Knowledge graph-based persistent memory system
    - **Filesystem** - Secure file operations with access controls
    - **GitHub** - Repository management and GitHub API integration
    - **Google Drive** - File access and search capabilities
    - **Slack** - Channel management and messaging
    - **Puppeteer** - Browser automation and web scraping
    - **Brave Search** - Web and local search integration
    - **Google Maps** - Location services and directions

    ### Python-based Servers
    - **SQLite** - Local database operations
    - **Git** - Local repository management
    - **Fetch** - Web content fetching and conversion
    - **PostgreSQL** - Read-only database access

    ## Prerequisites
    1. Install Node.js (v18.x or later)
    - Download from: https://nodejs.org/
    @@ -34,16 +53,16 @@ npm install -g @modelcontextprotocol/server-<name>
    # Examples
    npm install -g @modelcontextprotocol/server-memory
    npm install -g @modelcontextprotocol/server-everything
    npm install -g @modelcontextprotocol/server-github
    ```

    #### For Python-based servers:
    ```powershell
    # General format
    # Using uvx (recommended)
    uvx mcp-server-<name>
    # Example
    uvx mcp-server-sqlite
    # Alternative using pip
    pip install mcp-server-<name>
    ```

    ### 3. Configure Claude Desktop
    @@ -57,55 +76,37 @@ uvx mcp-server-sqlite
    {
    "globalShortcut": "Ctrl+Space",
    "mcpServers": {
    "python-server": {
    "command": "uvx",
    "args": ["mcp-server-name", "--arg", "value"],
    "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\path\\to\\files"]
    },
    "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
    "OPTIONAL_ENV_VAR": "value"
    "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
    }
    },
    "node-server": {
    "postgres": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-name"]
    "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    },
    "git": {
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "C:\\path\\to\\repo"]
    }
    }
    }
    ```

    ### 4. Common Server Configurations

    #### SQLite Server
    ```json
    "sqlite": {
    "command": "uvx",
    "args": ["mcp-server-sqlite", "--db-path", "C:\\Users\\YourUsername\\test.db"]
    }
    ```

    #### Memory Server
    ```json
    "memory": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
    ```

    #### Everything Server
    ```json
    "everything": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-everything"]
    }
    ```

    ## Verification & Troubleshooting

    ### Verify Installations
    ```powershell
    # Check Node.js packages
    npm list -g --depth=0
    # Test server directly
    # Test servers directly
    npx @modelcontextprotocol/server-memory
    uvx mcp-server-sqlite
    ```
    @@ -129,4 +130,10 @@ uvx mcp-server-sqlite
    - Always use double backslashes (\\) for Windows paths in JSON
    - Run installation commands as administrator
    - Keep package managers and servers updated
    - Check server documentation for specific requirements
    - Check server documentation for specific requirements
    - Visit [modelcontextprotocol.io](https://modelcontextprotocol.io) for detailed documentation

    ## Additional Resources
    - [GitHub Repository](https://github.com/modelcontextprotocol/servers)
    - [Contributing Guidelines](https://github.com/modelcontextprotocol/servers/blob/main/CONTRIBUTING.md)
    - [Security Policy](https://github.com/modelcontextprotocol/servers/blob/main/SECURITY.md)
  3. @feveromo feveromo created this gist Nov 26, 2024.
    132 changes: 132 additions & 0 deletions .md
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,132 @@
    # Setting Up MCP Servers on Windows
    A step-by-step guide to setting up Model Context Protocol (MCP) servers for Claude Desktop on Windows.

    ## Prerequisites
    1. Install Node.js (v18.x or later)
    - Download from: https://nodejs.org/
    - Verify installation by opening PowerShell and running:
    ```powershell
    node --version
    npm --version
    ```
    2. Install Python 3.10 or later (required for Python-based servers)
    - Download from: https://www.python.org/downloads/
    - Make sure to check "Add Python to PATH" during installation
    ## Installation Steps
    ### 1. Install Package Managers
    Open PowerShell as administrator and run:
    ```powershell
    # For Python-based servers
    npm install -g uv
    # Node.js package manager (npm) comes with Node.js installation
    ```

    ### 2. Install MCP Servers

    #### For Node.js-based servers:
    ```powershell
    # General format
    npm install -g @modelcontextprotocol/server-<name>
    # Examples
    npm install -g @modelcontextprotocol/server-memory
    npm install -g @modelcontextprotocol/server-everything
    ```

    #### For Python-based servers:
    ```powershell
    # General format
    uvx mcp-server-<name>
    # Example
    uvx mcp-server-sqlite
    ```

    ### 3. Configure Claude Desktop

    1. Open File Explorer and navigate to:
    - `%AppData%\Claude Desktop\`
    - Create `claude_desktop_config.json` if it doesn't exist

    2. Example configuration structure:
    ```json
    {
    "globalShortcut": "Ctrl+Space",
    "mcpServers": {
    "python-server": {
    "command": "uvx",
    "args": ["mcp-server-name", "--arg", "value"],
    "env": {
    "OPTIONAL_ENV_VAR": "value"
    }
    },
    "node-server": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-name"]
    }
    }
    }
    ```

    ### 4. Common Server Configurations

    #### SQLite Server
    ```json
    "sqlite": {
    "command": "uvx",
    "args": ["mcp-server-sqlite", "--db-path", "C:\\Users\\YourUsername\\test.db"]
    }
    ```

    #### Memory Server
    ```json
    "memory": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
    ```

    #### Everything Server
    ```json
    "everything": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-everything"]
    }
    ```

    ## Verification & Troubleshooting

    ### Verify Installations
    ```powershell
    # Check Node.js packages
    npm list -g --depth=0
    # Test server directly
    npx @modelcontextprotocol/server-memory
    uvx mcp-server-sqlite
    ```

    ### Common Issues
    1. "Command not found"
    - Verify Node.js/Python are in PATH
    - Try running PowerShell as administrator

    2. "Could not attach to MCP server"
    - Check config file paths are correct
    - Use double backslashes (\\) in Windows paths
    - Verify server package is installed

    3. Server not showing in Claude
    - Restart Claude Desktop
    - Check config file location
    - Enable DEBUG env variable in config

    ## Tips
    - Always use double backslashes (\\) for Windows paths in JSON
    - Run installation commands as administrator
    - Keep package managers and servers updated
    - Check server documentation for specific requirements