MukMcp

A Go-based MCP (Model Context Protocol) server that exposes tools for GitHub, Google Drive, Gmail, ESPN Fantasy Football, and FPL Draft.

Features

• GitHub (10 tools): Repos, issues, PRs, code search, file access
• Google Drive (10 tools): Files, folders, search, share, CRUD operations
• Gmail (14 tools): Messages, threads, send, labels, search
• ESPN Fantasy Football (12 tools): Multiple leagues, teams, rosters, matchups, players
• FPL Draft (12 tools): League, team, players, fixtures, standings

Installation

Prerequisites

• Go 1.22 or later
• gh CLI authenticated (for GitHub functionality)
• Google Cloud OAuth credentials (for Drive/Gmail)
• ESPN Fantasy league cookies (for private leagues)
• FPL account (for Draft leagues)

Build

go build -o mukmcp ./cmd/mukmcp

Configuration

Create a configuration file at ~/.mukmcp/config.yaml:

# GitHub - uses gh CLI authentication by default
github:
  # Optional: explicit token override
  # token: "ghp_xxxxxxxxxxxx"

# Google APIs (Drive and Gmail)
google:
  client_id: "your-client-id.apps.googleusercontent.com"
  client_secret: "your-client-secret"
  token_file: "~/.mukmcp/google_token.json"
  scopes:
    - "https://www.googleapis.com/auth/drive"
    - "https://www.googleapis.com/auth/gmail.modify"
    - "https://www.googleapis.com/auth/gmail.send"

# ESPN Fantasy Football (supports multiple leagues)
espn:
  leagues:
    - name: "Main League"
      league_id: "12345678"
      swid: "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}"
      espn_s2: "AEB..."
      season: 2025
    - name: "Work League"
      league_id: "87654321"
      swid: "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}"
      espn_s2: "AEB..."
      season: 2025

# FPL Draft
fpl:
  email: "your-email@example.com"
  token_file: "~/.mukmcp/fpl_token.json"
  # Or use browser cookie directly
  # cookie: "your-pl-profile-cookie"

Getting ESPN Cookies

1. Log in to ESPN Fantasy at https://fantasy.espn.com
2. Open browser Developer Tools (F12)
3. Go to Application > Cookies
4. Copy the values for SWID and espn_s2

Setting up Google OAuth

1. Go to Google Cloud Console
2. Create a new project or select existing
3. Enable the Google Drive API and Gmail API
4. Go to Credentials > Create Credentials > OAuth Client ID
5. Select "Desktop app" as the application type
6. Download the credentials and add client_id and client_secret to your config

On first use, the server will prompt you to complete the OAuth flow.

Usage

Claude Desktop

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mukmcp": {
      "command": "/path/to/mukmcp",
      "args": [],
      "env": {
        "MUKMCP_CONFIG": "~/.mukmcp/config.yaml"
      }
    }
  }
}

Direct Usage

The server communicates via stdio using the MCP protocol:

./mukmcp

Available Tools

GitHub Tools

Tool	Description
github_list_repos	List repositories for user or org
github_get_repo	Get repository details
github_list_issues	List issues in a repository
github_create_issue	Create a new issue
github_get_issue	Get issue details
github_list_prs	List pull requests
github_get_pr	Get pull request details
github_search_code	Search code across repositories
github_get_file	Get file contents
github_list_commits	List commits

Google Drive Tools

Tool	Description
drive_list_files	List files and folders
drive_search	Search files by name
drive_get_file	Get file metadata
drive_read_file	Read file contents
drive_create_file	Create a new file
drive_update_file	Update file contents
drive_delete_file	Delete a file
drive_create_folder	Create a folder
drive_share_file	Share with users
drive_list_shared	List shared files

Gmail Tools

Tool	Description
gmail_list_messages	List inbox messages
gmail_search	Search emails
gmail_get_message	Get message details
gmail_send_email	Send an email
gmail_reply	Reply to email
gmail_forward	Forward email
gmail_list_labels	List all labels
gmail_add_label	Add label to message
gmail_remove_label	Remove label
gmail_mark_read	Mark as read
gmail_mark_unread	Mark as unread
gmail_trash	Move to trash
gmail_list_threads	List threads
gmail_get_thread	Get full thread

ESPN Fantasy Tools

Tool	Description
espn_list_leagues	List configured leagues
espn_get_league	Get league info
espn_get_teams	Get all teams
espn_get_team	Get team details
espn_get_roster	Get team roster
espn_get_matchups	Get week matchups
espn_get_scoreboard	Current scoreboard
espn_get_standings	League standings
espn_get_players	Available players
espn_get_player	Player details
espn_get_transactions	Recent transactions
espn_get_draft_recap	Draft results

FPL Draft Tools

Tool	Description
fpl_get_bootstrap	All FPL data
fpl_get_league	League details
fpl_get_my_team	User's team
fpl_get_player	Player details
fpl_get_player_stats	Player stats
fpl_get_fixtures	Fixtures
fpl_get_standings	Standings
fpl_get_transactions	Transactions
fpl_get_watchlist	Watchlist
fpl_search_players	Search players
fpl_get_gameweek	Gameweek info
fpl_get_element_status	Player availability

License

MIT