mcpeasy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5a8fd6efbce3698cb6ab7c807ee5b496f6f150108779991c4b2dac8d28822a64
+  data.tar.gz: 98e8f1895a741151767ca65243f3d83adc3feb37342624c35834bf2d0e4beeb4
+SHA512:
+  metadata.gz: '07081dab8205a10e379933b40f9f618e7cb0ff05781f77b4ee7700c4a64b67f309346510d7677b813c09498a5172622ec8290294b4ffecdef5f6143a4777cac6'
+  data.tar.gz: 14e812027277e6035e6ab21cfb0730b35e1084c03b17ea2ca905a3654923da14fa2a8c183295904f913262a9a24e56078019384344387da7735523d8de148eb3

data/.claude/settings.json

@@ -0,0 +1,15 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(bundle install:*)",
+      "Bash(bundle exec standardrb:*)",
+      "Bash(git status:*)",
+      "Bash(git diff:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(open https://meet.google.com/:*)"
+    ],
+    "deny": []
+  }
+}

data/.claudeignore

@@ -0,0 +1,4 @@
+.env
+client_secret_*.apps.googleusercontent.com.json
+google_credentials.json
+.google-token.json

data/.envrc

@@ -0,0 +1,2 @@
+# Load environment variables from .env file
+dotenv

data/.mcp.json

@@ -0,0 +1,40 @@
+{
+  "mcpServers": {
+    "slack": {
+      "type": "stdio",
+      "command": "./bin/mcpz",
+      "args": [
+        "slack",
+        "mcp"
+      ],
+      "env": {}
+    },
+    "gdrive": {
+      "type": "stdio",
+      "command": "./bin/mcpz",
+      "args": [
+        "gdrive",
+        "mcp"
+      ],
+      "env": {}
+    },
+    "gcal": {
+      "type": "stdio",
+      "command": "./bin/mcpz",
+      "args": [
+        "gcal",
+        "mcp"
+      ],
+      "env": {}
+    },
+    "gmeet": {
+      "type": "stdio",
+      "command": "./bin/mcpz",
+      "args": [
+        "gmeet",
+        "mcp"
+      ],
+      "env": {}
+    }
+  }
+}

data/CLAUDE.md

@@ -0,0 +1,170 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**MCPEasy** is a Ruby gem that provides multiple Model Context Protocol (MCP) servers for integrating with AI assistants like Claude Code. The gem includes MCP servers for:
+
+- **Slack** - Post messages and list channels
+- **Google Calendar** - Access and search calendar events
+- **Google Drive** - Search and retrieve files with automatic format conversion
+- **Google Meet** - Find and manage Google Meet meetings
+
+Each MCP server provides both CLI functionality and MCP server capabilities for AI assistant integration.
+
+## Dependencies and Setup
+
+### Development Setup
+
+Install dependencies:
+```bash
+bundle install
+```
+
+### Local Testing
+
+Build and install the gem locally:
+```bash
+gem build mcpeasy.gemspec
+gem install mcpeasy-*.gem
+```
+
+The gem is now available as the `mcpz` command system-wide.
+
+## Common Commands
+
+### Gem CLI Commands
+
+```bash
+# Setup configuration directories
+mcpz setup
+
+# Check configuration status
+mcpz config
+
+# Set up authentication
+mcpz google auth
+mcpz slack set_bot_token xoxb-your-token
+
+# Use individual services
+mcpz slack post general "Hello world"
+mcpz gcal events --start "2024-01-01"
+mcpz gdrive search "quarterly report"
+mcpz gmeet upcoming
+
+# Run MCP servers
+mcpz slack mcp
+mcpz gcal mcp
+mcpz gdrive mcp
+mcpz gmeet mcp
+```
+
+### Development Commands
+
+Run linting:
+```bash
+bundle exec standardrb
+```
+
+Build gem:
+```bash
+gem build mcpeasy.gemspec
+```
+
+### MCP Server Configuration
+
+For use with Claude Code, add to `.mcp.json`:
+```json
+{
+  "mcpServers": {
+    "slack": {
+      "command": "mcpz",
+      "args": ["slack", "mcp"]
+    },
+    "gcal": {
+      "command": "mcpz",
+      "args": ["gcal", "mcp"]
+    },
+    "gdrive": {
+      "command": "mcpz",
+      "args": ["gdrive", "mcp"]
+    },
+    "gmeet": {
+      "command": "mcpz",
+      "args": ["gmeet", "mcp"]
+    }
+  }
+}
+```
+
+## Code Quality
+
+**IMPORTANT**: When editing Ruby source code, you MUST run `bundle exec standardrb` after making changes and fix any linting issues that are reported.
+
+## Architecture
+
+### Gem Structure
+```
+lib/
+├── mcpeasy.rb           # Main gem entry point
+├── mcpeasy/             # Core gem functionality
+│   ├── version.rb       # Gem version
+│   ├── config.rb        # Configuration management
+│   └── cli.rb           # Thor-based CLI interface
+└── utilities/           # Individual MCP servers
+    ├── slack/           # Slack integration
+    ├── gcal/            # Google Calendar
+    ├── gdrive/          # Google Drive
+    └── gmeet/           # Google Meet
+```
+
+### Core Components
+
+#### CLI (lib/mcpeasy/cli.rb)
+- Thor-based command-line interface
+- Subcommands for each service (slack, gcal, gdrive, gmeet)
+- Configuration and setup commands
+- Unified `mcpz` executable
+
+#### Config (lib/mcpeasy/config.rb)
+- Manages credentials and configuration
+- Stores settings in `~/.config/mcpeasy/`
+- Handles Google OAuth and Slack tokens
+
+#### Individual MCP Servers
+Each service directory follows a consistent structure with four key components:
+
+##### `cli.rb` - Service-specific CLI Commands
+- Extends Thor for command-line interface functionality
+- Provides user-friendly CLI commands for the service
+- Handles argument parsing and validation
+- Calls into the `*_tool.rb` for actual service operations
+- Example: `mcpz slack post` command implementation
+
+##### `mcp.rb` - MCP Server Implementation
+- Implements the Model Context Protocol JSON-RPC server
+- Handles MCP initialization, tool registration, and request processing
+- Translates MCP tool calls into `*_tool.rb` method calls
+- Provides structured responses back to AI assistants
+- Runs as a persistent server process when called with `mcpz [service] mcp`
+
+##### `*_tool.rb` - Core Service Functionality
+- Contains the main business logic for interacting with external APIs
+- Handles authentication, API calls, error handling, and response formatting
+- Shared between both CLI and MCP modes for consistency
+- Service-specific naming: `slack_tool.rb`, `gcal_tool.rb`, `gdrive_tool.rb`, `gmeet_tool.rb`
+- Designed to be framework-agnostic and reusable
+
+##### `README.md` - Service-specific Documentation
+- Detailed setup instructions for the specific service
+- API credential configuration steps
+- CLI usage examples and MCP server configuration
+- Service-specific features and limitations
+- Troubleshooting guides
+
+### Execution Patterns
+All services follow the same pattern:
+1. **CLI mode**: Direct command-line usage via `mcpz [service] [command]`
+2. **MCP mode**: JSON-RPC server mode via `mcpz [service] mcp`
+3. **Authentication**: Service-specific auth handling with shared config storage

data/README.md

@@ -0,0 +1,161 @@
+# MCPEasy
+
+A Ruby gem that provides multiple Model Context Protocol (MCP) servers for integrating with AI assistants like Claude Code. Each MCP server provides programmatic access to popular web services and APIs.
+
+## Installation
+
+Install the gem globally:
+
+```bash
+gem install mcpeasy
+```
+
+This makes the `mcpz` command available system-wide for both CLI usage and MCP server configuration.
+
+## Available MCP Servers
+
+This gem includes the following MCP servers, each providing both CLI and MCP server functionality:
+
+### 🗣️ [Slack](./lib/utilities/slack/)
+Post messages to Slack channels and list available channels.
+- CLI: Direct message posting with custom usernames
+- MCP: Integration for AI assistants to send Slack notifications
+
+### 📅 [Google Calendar](./lib/utilities/gcal/)
+Access and search Google Calendar events.
+- CLI: List events, search by date range, view calendar information
+- MCP: AI assistant access to calendar data and event search
+
+### 📂 [Google Drive](./lib/utilities/gdrive/)
+Search and retrieve files from Google Drive with automatic format conversion.
+- CLI: Search files, list recent files, retrieve content
+- MCP: AI assistant access to Drive files and documents
+
+### 🎥 [Google Meet](./lib/utilities/gmeet/)
+Find and manage Google Meet meetings from your calendar.
+- CLI: List meetings, search by content, get meeting URLs
+- MCP: AI assistant access to upcoming meetings and direct links
+
+## Quick Start
+
+### 1. Configuration Setup
+
+First, create the configuration directories:
+
+```bash
+mcpz setup
+```
+
+Then configure your API credentials for each service you plan to use:
+
+```bash
+# For Slack
+mcpz slack set_bot_token xoxb-your-slack-token
+
+# For Google services (Calendar, Drive, Meet)
+mcpz google auth
+```
+
+Credentials are stored securely in `~/.config/mcpeasy/` (see individual server documentation for specific setup requirements).
+
+### 2. CLI Usage
+
+Each MCP server can be used directly from the command line:
+
+```bash
+# Slack
+mcpz slack post general "Hello from Ruby!"
+
+# Google Calendar  
+mcpz gcal events --start "2024-01-01"
+
+# Google Drive
+mcpz gdrive search "quarterly report"
+
+# Google Meet
+mcpz gmeet upcoming
+```
+
+### 3. MCP Server Configuration
+
+For use with Claude Code, add servers to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "slack": {
+      "command": "mcpz",
+      "args": ["slack", "mcp"]
+    },
+    "gcal": {
+      "command": "mcpz", 
+      "args": ["gcal", "mcp"]
+    },
+    "gdrive": {
+      "command": "mcpz",
+      "args": ["gdrive", "mcp"]
+    },
+    "gmeet": {
+      "command": "mcpz",
+      "args": ["gmeet", "mcp"]
+    }
+  }
+}
+```
+
+## Development
+
+### Setup
+
+1. Clone the repository and install dependencies:
+   ```bash
+   git clone <repository-url>
+   cd mcpeasy
+   bundle install
+   ```
+
+2. Create configuration directories (if not automatically created):
+   ```bash
+   # Run manually during development
+   bundle exec ruby -r "./lib/mcpeasy/setup" -e "Mcpeasy::Setup.create_config_directories"
+   
+   # Or use the CLI command after building the gem locally
+   bin/mcpz setup
+   ```
+
+### Code Quality
+
+Run linting before committing changes:
+
+```bash
+bundle exec standardrb
+```
+
+### Project Structure
+
+```
+lib/
+├── mcpeasy.rb           # Main gem file
+├── mcpeasy/             # Gem core functionality
+└── utilities/           # MCP servers
+    ├── slack/           # Slack integration
+    ├── gcal/            # Google Calendar
+    ├── gdrive/          # Google Drive  
+    └── gmeet/           # Google Meet
+```
+
+### Contributing
+
+1. Follow existing code patterns and Ruby style conventions
+2. Add comprehensive error handling and logging
+3. Update relevant documentation for new features
+4. Test both CLI and MCP server modes
+5. Run `bundle exec standardrb` before submitting changes
+
+## License
+
+This project is licensed under the MIT License.
+
+## Support
+
+For issues, questions, or contributions, please visit the project repository.

data/bin/mcpz

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/mcpeasy"
+
+Mcpeasy::CLI.start(ARGV)

data/env.template

@@ -0,0 +1,11 @@
+# Copy this file to .env and replace the placeholders with your own values
+
+# Used by the slack_poster.rb script
+SLACK_BOT_TOKEN=xoxb-REPLACE-ME
+
+# Used by the Github MCP Server
+GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_REPLACE_ME
+
+# Used by the Google Drive MCP Server
+GOOGLE_CLIENT_ID=your_client_id_here.apps.googleusercontent.com
+GOOGLE_CLIENT_SECRET=your_client_secret_here

data/ext/setup.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/mcpeasy/setup"
+
+# This script runs during gem installation
+Mcpeasy::Setup.create_config_directories

data/lib/mcpeasy/cli.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+require "thor"
+require_relative "config"
+
+module Mcpeasy
+  class GoogleCommands < Thor
+    desc "auth", "Authenticate with Google services (Calendar, Drive, Meet)"
+    def auth
+      require_relative "../utilities/gcal/gcal_tool"
+      tool = GcalTool.new(skip_auth: true)
+      result = tool.authenticate
+      if result[:success]
+        puts "✅ Successfully authenticated with Google services"
+        puts "   This enables access to Calendar, Drive, and Meet"
+      else
+        puts "❌ Authentication failed: #{result[:error]}"
+        exit 1
+      end
+    end
+  end
+
+  # Load the existing GcalCLI and extend it with MCP functionality
+  require_relative "../utilities/gcal/cli"
+
+  class GcalCommands < GcalCLI
+    namespace "gcal"
+
+    desc "mcp", "Run Google Calendar MCP server"
+    def mcp
+      require_relative "../utilities/gcal/mcp"
+      MCPServer.new.run
+    end
+  end
+
+  # Load the existing GdriveCLI and extend it with MCP functionality
+  require_relative "../utilities/gdrive/cli"
+
+  class GdriveCommands < GdriveCLI
+    namespace "gdrive"
+
+    desc "mcp", "Run Google Drive MCP server"
+    def mcp
+      require_relative "../utilities/gdrive/mcp"
+      MCPServer.new.run
+    end
+  end
+
+  # Load the existing GmeetCLI and extend it with MCP functionality
+  require_relative "../utilities/gmeet/cli"
+
+  class GmeetCommands < GmeetCLI
+    namespace "gmeet"
+
+    desc "mcp", "Run Google Meet MCP server"
+    def mcp
+      require_relative "../utilities/gmeet/mcp"
+      MCPServer.new.run
+    end
+  end
+
+  # Load the existing SlackCLI and extend it with MCP functionality
+  require_relative "../utilities/slack/cli"
+
+  class SlackCommands < SlackCLI
+    namespace "slack"
+
+    desc "mcp", "Run Slack MCP server"
+    def mcp
+      require_relative "../utilities/slack/mcp"
+      MCPServer.new.run
+    end
+
+    desc "set_bot_token TOKEN", "Set Slack bot token"
+    def set_bot_token(token)
+      Config.save_slack_bot_token(token)
+      puts "✅ Slack bot token saved successfully"
+    end
+
+    # Alias the inherited 'list' command as 'channels' for consistency
+    desc "channels", "List Slack channels"
+    def channels
+      list
+    end
+  end
+
+  class CLI < Thor
+    desc "version", "Show mcpeasy version"
+    def version
+      puts "mcpeasy #{Mcpeasy::VERSION}"
+      puts "mcpeasy, LM squeezy! 🤖"
+    end
+
+    desc "setup", "Create configuration directories"
+    def setup
+      require_relative "setup"
+      Setup.create_config_directories
+    end
+
+    desc "config", "Show configuration status"
+    def config
+      status = Config.config_status
+      puts "📁 Config directory: #{status[:config_dir]}"
+      puts "📄 Logs directory: #{status[:logs_dir]}"
+      puts "🔑 Google credentials: #{status[:google_credentials] ? "✅" : "❌"}"
+      puts "🎫 Google token: #{status[:google_token] ? "✅" : "❌"}"
+      puts "💬 Slack config: #{status[:slack_config] ? "✅" : "❌"}"
+    end
+
+    desc "set_google_credentials PATH", "Save Google credentials from downloaded JSON file"
+    def set_google_credentials(path)
+      unless File.exist?(path)
+        puts "❌ File not found: #{path}"
+        exit 1
+      end
+
+      begin
+        credentials_json = File.read(path)
+        JSON.parse(credentials_json) # Validate it's valid JSON
+        Config.save_google_credentials(credentials_json)
+        puts "✅ Google credentials saved successfully"
+      rescue JSON::ParserError
+        puts "❌ Invalid JSON file"
+        exit 1
+      rescue => e
+        puts "❌ Error saving credentials: #{e.message}"
+        exit 1
+      end
+    end
+
+    desc "google COMMAND", "Google services authentication"
+    subcommand "google", GoogleCommands
+
+    desc "gcal COMMAND", "Google Calendar commands"
+    subcommand "gcal", GcalCommands
+
+    desc "gdrive COMMAND", "Google Drive commands"
+    subcommand "gdrive", GdriveCommands
+
+    desc "gmeet COMMAND", "Google Meet commands"
+    subcommand "gmeet", GmeetCommands
+
+    desc "slack COMMAND", "Slack commands"
+    subcommand "slack", SlackCommands
+
+    class << self
+      private
+
+      def exit_on_failure?
+        true
+      end
+    end
+  end
+end

data/lib/mcpeasy/config.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "json"
+require "mother"
+
+module Mcpeasy
+  class Config
+    CONFIG_DIR = File.expand_path("~/.config/mcpeasy").freeze
+    GOOGLE_DIR = File.join(CONFIG_DIR, "google").freeze
+    SLACK_DIR = File.join(CONFIG_DIR, "slack").freeze
+    LOGS_DIR = File.expand_path("~/.local/share/mcpeasy/logs").freeze
+
+    class << self
+      def ensure_config_dirs
+        FileUtils.mkdir_p(CONFIG_DIR)
+        FileUtils.mkdir_p(GOOGLE_DIR)
+        FileUtils.mkdir_p(SLACK_DIR)
+        FileUtils.mkdir_p(LOGS_DIR)
+      end
+
+      # Google credentials management
+      def google_credentials_path
+        File.join(GOOGLE_DIR, "credentials.json")
+      end
+
+      def google_credentials
+        return nil unless File.exist?(google_credentials_path)
+        Mother.create(google_credentials_path)
+      end
+
+      def save_google_credentials(credentials_json)
+        ensure_config_dirs
+        File.write(google_credentials_path, credentials_json)
+      end
+
+      def google_client_id
+        credentials = google_credentials
+        return nil unless credentials
+        credentials.installed&.client_id || credentials.web&.client_id
+      end
+
+      def google_client_secret
+        credentials = google_credentials
+        return nil unless credentials
+        credentials.installed&.client_secret || credentials.web&.client_secret
+      end
+
+      # Google token management
+      def google_token_path
+        File.join(GOOGLE_DIR, "token.json")
+      end
+
+      def google_token
+        return nil unless File.exist?(google_token_path)
+        Mother.create(google_token_path)
+      end
+
+      def save_google_token(token_data)
+        ensure_config_dirs
+        File.write(google_token_path, JSON.pretty_generate(token_data))
+      end
+
+      # Slack configuration
+      def slack_token_path
+        File.join(SLACK_DIR, "token.json")
+      end
+
+      def slack_bot_token
+        return nil unless File.exist?(slack_token_path)
+        config = JSON.parse(File.read(slack_token_path))
+        config["bot_token"]
+      end
+
+      def save_slack_bot_token(token)
+        ensure_config_dirs
+        config = File.exist?(slack_token_path) ? JSON.parse(File.read(slack_token_path)) : {}
+        config["bot_token"] = token
+        File.write(slack_token_path, JSON.pretty_generate(config))
+      end
+
+      # Logs directory
+      def logs_dir
+        LOGS_DIR
+      end
+
+      def log_file_path(service, type = "error")
+        File.join(LOGS_DIR, "mcp_#{service}_#{type}.log")
+      end
+
+      def config_status
+        {
+          config_dir: CONFIG_DIR,
+          logs_dir: LOGS_DIR,
+          google_credentials: File.exist?(google_credentials_path),
+          google_token: File.exist?(google_token_path),
+          slack_config: File.exist?(slack_token_path)
+        }
+      end
+    end
+  end
+end