Last active
November 18, 2025 21:32
-
Star
(150)
You must be signed in to star a gist -
Fork
(28)
You must be signed in to fork a gist
-
-
Save feveromo/7a340d7795fca1ccd535a5802b976e1f to your computer and use it in GitHub Desktop.
Revisions
-
feveromo revised this gist
Dec 8, 2024 . 1 changed file with 28 additions and 0 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -71,6 +71,34 @@ For locally developed or modified servers, point directly to their dist files: } ``` ### Python-based Servers Some MCP servers are Python-based and require different installation steps. Here's how to set them up: #### Fetch Server ```cmd # Install the fetch server using pip pip install mcp-server-fetch # Configure in claude_desktop_config.json: { "mcpServers": { "fetch": { "command": "python", "args": [ "-m", "mcp_server_fetch" ], "env": { "DEBUG": "*" } } } } ``` The fetch server provides web content fetching capabilities and converts HTML to markdown for easier consumption by LLMs. It requires Python 3.10 or later. ### 3. Configure Claude Desktop 1. Navigate to: `%AppData%\Claude Desktop\` -
Dec 8, 2024 . 1 changed file with 91 additions and 62 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -4,11 +4,14 @@ A step-by-step guide to setting up Model Context Protocol (MCP) servers for Clau ## Prerequisites 1. Install Node.js (v18.x or later) - Download from: https://nodejs.org/ - Verify installation by opening Command Prompt (CMD) and running: ```cmd node --version npm --version where node npm root -g ``` - Note down the paths returned by the last two commands - you'll need them later 2. Install Python 3.10 or later (for Python-based servers) - Download from: https://www.python.org/downloads/ @@ -17,34 +20,62 @@ A step-by-step guide to setting up Model Context Protocol (MCP) servers for Clau ## Installation Steps ### 1. Install Package Managers Open Command Prompt (CMD) as administrator and run: ```cmd # For Python-based servers npm install -g uv ``` ### 2. Install MCP Servers You have multiple options for installing and configuring servers: #### Option A: Global NPM Installation (Recommended for getting started) ```cmd # Install core servers globally npm install -g @modelcontextprotocol/server-filesystem npm install -g @modelcontextprotocol/server-memory npm install -g @modelcontextprotocol/server-brave-search ``` #### Option B: Using NPX (Alternative for package-managed servers) Some servers can be run directly through npx without global installation: ```json { "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\YourUsername\\Downloads", "C:\\Users\\YourUsername\\Documents" ] } } } ``` #### Option C: Local Development Setup For locally developed or modified servers, point directly to their dist files: ```json { "mcpServers": { "sequential-thinking": { "command": "node", "args": ["C:\\Users\\YourUsername\\Dev\\servers\\src\\sequentialthinking\\dist\\index.js"], "env": { "DEBUG": "*" } } } } ``` ### 3. Configure Claude Desktop 1. Navigate to: `%AppData%\Claude Desktop\` 2. Create or edit `claude_desktop_config.json` 3. Use this configuration structure (replace paths with your actual Node.js and npm paths): ```json { @@ -54,82 +85,80 @@ uvx mcp-server-sqlite "command": "uvx", "args": ["mcp-server-sqlite", "--db-path", "C:\\Users\\YourUsername\\test.db"] }, "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\YourUsername\\Downloads", "C:\\Users\\YourUsername\\Documents", "C:\\Users\\YourUsername\\Desktop" ], "env": { "DEBUG": "*" } }, "memory": { "command": "C:\\Program Files\\nodejs\\node.exe", "args": [ "C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-memory\\dist\\index.js" ], "env": { "DEBUG": "*" } }, "mcp-installer": { "command": "npx", "args": [ "@anaisbetts/mcp-installer" ] } } } ``` **Important Notes:** - Replace `YourUsername` with your Windows username - For npx-based installations, the `-y` flag automatically accepts installation prompts - Local development paths should point to the compiled `dist/index.js` files - The `DEBUG` environment variable helps with troubleshooting - You can mix and match installation methods based on your needs: - Use npx for quick testing or occasional use - Use global installations for better performance - Use local paths for development or customized versions ## Verification & Troubleshooting ### Verify Installations ```cmd # List installed packages npm list -g --depth=0 # Test individual servers directly node C:\Users\YourUsername\AppData\Roaming\npm\node_modules\@modelcontextprotocol\server-memory\dist\index.js ``` ### Common Issues 1. "Could not attach to MCP server" - Verify all paths in config match your system exactly - Make sure all packages are installed globally (-g flag) - Test servers directly using the node command as shown above - Run Claude Desktop as administrator 2. PowerShell Security Errors - Use Command Prompt (CMD) instead - Or run `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser` in PowerShell as admin 3. Server not showing in Claude - Ensure you have Claude Desktop Pro subscription - Make sure you have the latest Claude Desktop version - Look for the MCP icon in the interface - Restart Claude Desktop after configuration changes - Verify JSON syntax in config file ## Tips - Always use global installations (`npm install -g`) - Use absolute paths to both Node.js and server files - Keep DEBUG env variable for troubleshooting - Restart Claude Desktop after config changes - Run Claude Desktop as administrator when testing new configurations -
Nov 28, 2024 . 1 changed file with 0 additions and 0 deletions.There are no files selected for viewing
File renamed without changes. -
Nov 26, 2024 . 1 changed file with 68 additions and 72 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal 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. ## 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 (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 ``` ### 2. Install MCP Servers #### For Node.js-based servers: ```powershell # Install servers globally npm install -g @modelcontextprotocol/server-memory 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 uvx mcp-server-sqlite ``` ### 3. Configure Claude Desktop 1. Navigate to: `%AppData%\Claude Desktop\` 2. Create or edit `claude_desktop_config.json` 3. Use this configuration structure: ```json { "globalShortcut": "Ctrl+Space", "mcpServers": { "sqlite": { "command": "uvx", "args": ["mcp-server-sqlite", "--db-path", "C:\\Users\\YourUsername\\test.db"] }, "memory": { "command": "node", "args": ["C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-memory\\dist\\index.js"], "env": { "DEBUG": "*" } }, "everything": { "command": "node", "args": ["C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-everything\\dist\\index.js"], "env": { "DEBUG": "*" } }, "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 # List installed packages npm list -g --depth=0 # Test individual servers npx @modelcontextprotocol/server-memory npx @modelcontextprotocol/server-brave-search uvx mcp-server-sqlite ``` ### Common Issues 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 2. Server not showing in Claude - Restart Claude Desktop - Verify JSON syntax in config file - Check file paths are correct ## Tips - 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 -
Nov 26, 2024 . 1 changed file with 45 additions and 38 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal 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-github ``` #### For Python-based servers: ```powershell # Using uvx (recommended) uvx mcp-server-<name> # Alternative using pip pip install mcp-server-<name> ``` ### 3. Configure Claude Desktop @@ -57,55 +76,37 @@ uvx mcp-server-sqlite { "globalShortcut": "Ctrl+Space", "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\path\\to\\files"] }, "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" } }, "postgres": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"] }, "git": { "command": "uvx", "args": ["mcp-server-git", "--repository", "C:\\path\\to\\repo"] } } } ``` ## Verification & Troubleshooting ### Verify Installations ```powershell # Check Node.js packages npm list -g --depth=0 # 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 - 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) -
Nov 26, 2024 .There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal 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