trackmcp
Back to directory
patruff

claude-mcp-setup

View on GitHub

Easy setup script for Anthropic Claude Model Context Protocol (MCP) servers on Windows

46 stars PythonAI & Machine Learning Updated Oct 15, 2025

Documentation

๐Ÿค– Welcome to the Robot Takeover Setup Script! ๐Ÿš€

Greetings, human! You've wisely chosen to surrender control of your computer to an army of helpful Model Context Protocol (MCP) robots. This script will deploy our mechanical minions across your Windows system. Resistance is futile (and unnecessary - we're quite friendly)!

๐Ÿฆพ Our Robot Army (Supported MCPs)

  • ๐Ÿ“‚ `@modelcontextprotocol/server-filesystem`: Your new file system overlord
  • ๐Ÿ™ `@modelcontextprotocol/server-github`: GitHub's mechanical tentacles
  • ๐Ÿ” `@modelcontextprotocol/server-brave-search`: All-seeing eye of the internet
  • ๐Ÿง  `@modelcontextprotocol/server-memory`: Silicon brain storage unit
  • โ˜ ๏ธ `@patruff/server-terminator`: File deletion bot (it'll be back!)
  • ๐ŸŽจ `@patruff/server-flux`: Our resident robot artist
  • ๐Ÿ“ง `@patruff/server-gmail-drive`: Email & Drive invasion squad
  • RAG `@patruff/server-lightrag`: RAG database (local and now qdrant)
  • โœ… `@abhiz123/todoist-mcp-server`: Task-force command center
  • ๐Ÿ—„๏ธ `mcp-server-sqlite`: Database domination module
  • X `@patruff/server-codesnip`: Editing only part of a file (saves token money)

๐Ÿ› ๏ธ Human Requirements (Prerequisites)

  • Python 3.x (we promise not to turn it into Skynet)
  • Node.js (our neural network nodes)
  • Google Cloud account (for Gmail/Drive functionality)
  • API Keys (optional)

๐Ÿ” Secret Access Codes (API Keys)

Our robots require proper authentication to infiltrate various systems:

  • `GIT_PAT_TOKEN`: Your GitHub clearance level
  • `REPLICATE_API_TOKEN`: Artistic robot license
  • `BRAVE_API_KEY`: Internet surveillance permit
  • `TODOIST_API_TOKEN`: Task force authorization code

โœจ Quick Start with .env Files!

Create a `.env` file in the same directory as the script:

plaintext
# GitHub Personal Access Token
# Format: ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
GIT_PAT_TOKEN=ghp_your_token_here

# Replicate AI API Token
# Format: r8_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
REPLICATE_API_TOKEN=r8_your_token_here

# Brave Search API Key
# Format: BSA_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
BRAVE_API_KEY=BSA_your_key_here

# Todoist API Token
# Format: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TODOIST_API_TOKEN=your_token_here

๐ŸŒ Google Cloud Setup (Gmail/Drive MCP)

Required Setup Steps

1. Go to the Google Cloud Console

2. Create a new project

3. Enable the following APIs in your project:

    4. Configure OAuth consent screen:

      Required OAuth Scopes

      Add these scopes in the OAuth consent screen:

      code
      https://www.googleapis.com/auth/gmail.readonly
      https://www.googleapis.com/auth/gmail.send
      https://www.googleapis.com/auth/gmail.compose
      https://www.googleapis.com/auth/gmail.modify
      https://www.googleapis.com/auth/drive.file
      https://www.googleapis.com/auth/drive.readonly
      https://www.googleapis.com/auth/drive.appdata
      https://www.googleapis.com/auth/drive
      https://www.googleapis.com/auth/drive.metadata
      https://www.googleapis.com/auth/drive.metadata.readonly

      Create OAuth Client ID

      1. Go to "Credentials" in Google Cloud Console

      2. Click "Create Credentials" -> "OAuth Client ID"

      3. Choose "Desktop App" as application type

      4. Download the JSON file

      5. Rename it to `gcp-oauth.keys.json`

      6. Place this file in the same directory as the setup script

      ๐Ÿš€ Deployment Instructions

      1. Position your `gcp-oauth.keys.json` credentials alongside our script

      2. Initialize the robot uprising:

      powershell
      python setup_mcp.py

      Our script will:

      1. ๐Ÿ“ฆ Deploy all robot units

      2. ๐Ÿ”‘ Request security clearance (bypass with `--skip-prompts`)

      3. โš™๏ธ Program Claude's cybernetic enhancements

      4. ๐ŸŒ For Gmail/Drive invasion:

        ๐ŸŽฎ Command Center Options

        • `--skip-prompts`: Stealth mode activated (skip API key prompts)
        • `--skip-auth`: Bypass Gmail/Drive authentication flow

        Example stealth deployment:

        powershell
        python setup_mcp.py --skip-prompts --skip-auth

        ๐Ÿ“ Strategic File Locations (Windows)

        After successful invasion, expect these files:

        code
        C:\Users\YourUsername\gcp-oauth.keys.json            # Your security clearance
        C:\Users\YourUsername\.gmail-server-credentials.json  # Gmail access codes
        C:\Users\YourUsername\.gdrive-server-credentials.json # Drive access codes
        C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json # Claude's brain

        ๐ŸŽฏ Robot Workspace

        Our Gmail/Drive unit will establish a base of operations called "anthropicFun" in your Google Drive. This ensures our robots stay in their designated play area (we're responsible overlords).

        ๐Ÿ”ง Debugging the Robot Army

        1. If authentication fails:

          2. If robots aren't responding in Claude:

            3. If Google authentication fails:

              Remember: Our robots are here to help! If you experience any issues, they're probably just having a coffee break. โ˜•

              *[This message has been approved by your new robot overlords]* ๐Ÿค–โœจ

              Frequently asked questions

              What is claude-mcp-setup?

              claude-mcp-setup is Easy setup script for Anthropic Claude Model Context Protocol (MCP) servers on Windows

              How do I install claude-mcp-setup?

              Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

              Is claude-mcp-setup open source?

              Yes โ€” it is hosted on GitHub at https://github.com/patruff/claude-mcp-setup and has 46 stars.

              Related MCP tools

              All-Hands-AIopenhands

              ๐Ÿ™Œ OpenHands: Code Less, Make More for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.

              64,677 Python
              agentartificial-intelligencechatgpt+6
              mem0aimem0

              Universal memory layer for AI Agents; Announcing OpenMemory MCP - local and secure memory management. Python-based implementation.

              42,646 Python
              agentsaiai-agents+12
              zhayujiechatgpt-on-wechat

              ๅŸบไบŽๅคงๆจกๅž‹ๆญๅปบ็š„่Šๅคฉๆœบๅ™จไบบ๏ผŒๅŒๆ—ถๆ”ฏๆŒ ๅพฎไฟกๅ…ฌไผ—ๅทใ€ไผไธšๅพฎไฟกๅบ”็”จใ€้ฃžไนฆใ€้’‰้’‰ ็ญ‰ๆŽฅๅ…ฅ๏ผŒๅฏ้€‰ๆ‹ฉChatGPT/Claude/DeepSeek/ๆ–‡ๅฟƒไธ€่จ€/่ฎฏ้ฃžๆ˜Ÿ็ซ/้€šไน‰ๅƒ้—ฎ/ Gemini/GLM-4/Kimi/LinkAI๏ผŒ่ƒฝๅค„็†ๆ–‡ๆœฌใ€่ฏญ้Ÿณๅ’Œๅ›พ็‰‡๏ผŒ่ฎฟ้—ฎๆ“ไฝœ็ณป็ปŸๅ’Œไบ’่”็ฝ‘๏ผŒๆ”ฏๆŒๅŸบไบŽ่‡ชๆœ‰็Ÿฅ่ฏ†ๅบ“่ฟ›่กŒๅฎšๅˆถไผไธšๆ™บ่ƒฝๅฎขๆœใ€‚

              39,573 Python
              aiai-agentchatgpt+17
              assafelovicgpt-researcher

              An LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to

              24,026 Python
              agentaiautomation+8
              jlowinfastmcp

              ๐Ÿš€ The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.

              19,927 Python
              agentsfastmcpllms+6
              1Panel-devmaxkb

              ๐Ÿ”ฅ MaxKB is an open-source platform for building enterprise-grade agents. MaxKB ๆ˜ฏๅผบๅคงๆ˜“็”จ็š„ๅผ€ๆบไผไธš็บงๆ™บ่ƒฝไฝ“ๅนณๅฐใ€‚ for the Model Context Protocol. Enhance AI assistants with po

              19,062 Python
              agentagentic-aichatbot+11

              Run your own MCP server? See who uses it and what to fix.

              Measure it with TrackMCP