claude-mcp-setup
by: patruff
Easy setup script for Anthropic Claude Model Context Protocol (MCP) servers on Windows
๐Overview
Purpose: The Robot Takeover Setup Script aims to deploy a suite of Model Context Protocol (MCP) robots to assist users in managing various system tasks on Windows.
Overview: This script features a user-friendly deployment process for multiple MCP robots designed to enhance file management, email handling, and task management by automating operations across various platforms including GitHub, Gmail, and Google Drive.
Key Features:
-
Multiple MCP Robots: Offers specialized robots for diverse tasks like file management, GitHub integration, memory storage, email operations, and database management, streamlining various workflows.
-
Easy Deployment and Setup: Provides straightforward setup instructions, environment variable configuration, and commands for initiating the robot army, enabling quick and effective implementation.
-
Custom Authentication: Supports specific API keys for secure integration with external services, ensuring that only authorized interactions occur, enhancing security while using cloud services.
๐ค 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@patruff/server-lightrag
: RAG database (local and now qdrant)@abhiz123/todoist-mcp-server
: Task-force command centermcp-server-sqlite
: Database domination module@patruff/server-codesnip
: Editing only part of a file (saves token money)
๐ ๏ธ Human Requirements (Prerequisites)
- Python 3.x
- Node.js
- 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 levelREPLICATE_API_TOKEN
: Artistic robot licenseBRAVE_API_KEY
: Internet surveillance permitTODOIST_API_TOKEN
: Task force authorization code
โจ Quick Start with .env Files
Create a .env
file in the same directory as the script with the following template:
GIT_PAT_TOKEN=ghp_your_token_here
REPLICATE_API_TOKEN=r8_your_token_here
BRAVE_API_KEY=BSA_your_key_here
TODOIST_API_TOKEN=your_token_here
๐ Google Cloud Setup (Gmail/Drive MCP)
Required Setup Steps
- Go to the Google Cloud Console
- Create a new project
- Enable the following APIs in your project:
- Google Drive API
- Gmail API
- Configure OAuth consent screen:
- Choose "External" user type
- Fill in app name and required fields
- Add your email as a test user
Required OAuth Scopes
Add these scopes in the OAuth consent screen:
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
- Go to "Credentials" in Google Cloud Console
- Click "Create Credentials" -> "OAuth Client ID"
- Choose "Desktop App" as application type
- Download the JSON file
- Rename it to
gcp-oauth.keys.json
- Place this file in the same directory as the setup script
๐ Deployment Instructions
- Position your
gcp-oauth.keys.json
credentials alongside the script - Initialize the robot uprising:
python setup_mcp.py
The script will:
- Deploy all robot units
- Request security clearance (bypass with
--skip-prompts
) - Program Claude's cybernetic enhancements
- For Gmail/Drive invasion:
- Copy your security credentials
- Launch browser-based authentication sequence
- Generate necessary access codes
๐ฎ Command Center Options
--skip-prompts
: Skip API key prompts--skip-auth
: Bypass Gmail/Drive authentication flow
Example stealth deployment:
python setup_mcp.py --skip-prompts --skip-auth
๐ Strategic File Locations (Windows)
After successful invasion, expect these files:
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 to keep robots in their designated area.
๐ง Debugging the Robot Army
- If authentication fails:
- Try rebooting the robots (
python setup_mcp.py --skip-prompts
) - Check your security clearance (OAuth credentials)
- Verify all necessary APIs are activated
- Confirm your test user status
- Try rebooting the robots (
- If robots aren't responding in Claude:
- Check configuration files
- Verify access codes
- Complete Google authentication
- If Google authentication fails:
- Verify all required scopes are added
- Confirm you are listed as a test user
- Ensure
gcp-oauth.keys.json
is correctly placed - Remove old credential files and reauthenticate
- To reauthenticate run node
"C:\Program Files\nodejs\node_modules\@patruff\server-gmail-drive\dist\index.js" auth
Remember: Our robots are here to help! If you experience issues, they're probably just having a coffee break. โ
[This message has been approved by your new robot overlords] ๐คโจ