This MCP server provides intelligent keyboard shortcut lookup using natural language queries powered by Claude Opus.
Key Capabilities:
Natural Language Querying: Search for keyboard shortcuts using conversational queries that Claude Opus intelligently matches against relevant shortcut data
Multi-Platform Support: Provides shortcuts for Ubuntu, macOS, and Windows across different operating systems
Desktop Environment Specificity: Includes shortcuts for desktop environments like GNOME and KDE
Application Coverage: Supports desktop apps (Firefox, VS Code), CLI tools (tmux, vim), and general system functions
Fast Performance: All shortcut data is loaded in-memory for quick filtering and retrieval
Claude Integration: Designed as an MCP server for Claude Desktop and Claude's Computer Use tool to enable automated computer interactions
Provides keyboard shortcuts for Firefox browser functionality including tab management, navigation, and browser-specific features
Provides keyboard shortcuts for GNOME desktop environment including window management, system functions, and desktop-specific operations
Provides keyboard shortcuts for KDE desktop environment operations and functionality
Provides keyboard shortcuts for macOS system operations, window management, and native applications
Provides keyboard shortcuts for tmux terminal multiplexer including pane management, window operations, and session control
Provides keyboard shortcuts for Ubuntu Linux system operations, applications, and desktop environment interactions
Provides keyboard shortcuts for Vim text editor including navigation, editing commands, and modal operations
Keyboard Shortcuts MCP Server
A Model Context Protocol (MCP) server that provides keyboard shortcuts for various operating systems, desktop environments, and applications. Uses Claude Opus for intelligent natural language querying of shortcuts.
Primary Use Case: Designed to support Claude's Computer Use tool by providing accurate, context-aware keyboard shortcuts for automated computer interactions.
Features
š Intelligent Search: Uses Claude Opus to understand natural language queries
š„ļø Multi-Platform: Support for Ubuntu (GNOME desktop), with architecture for macOS/Windows
š± App-Specific: Desktop apps (Firefox, VS Code), CLI tools (tmux, vim), and system shortcuts
š Fast: All shortcut data loaded in-memory for quick filtering
Installation
Configuration
Set your Anthropic API key as an environment variable:
Usage
Running Standalone
Integrating with Claude Desktop
Add to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json
on macOS):
Tool: get_shortcuts
Query keyboard shortcuts using natural language.
Parameters
os
(required): Operating system -"ubuntu"
,"macos"
, or"windows"
query
(required): Natural language question about shortcutsdesktop
(optional): Desktop environment -"gnome"
,"kde"
, etc.application
(optional): Specific application -"firefox"
,"tmux"
, etc.
Examples
Data Structure
Shortcuts are organized as:
Each JSON file contains:
Development
Architecture
Data Loader (
src/data-loader.ts
): Loads all JSON files at startup into memoryOpus Client (
src/opus-client.ts
): Wraps Anthropic SDK for intelligent queriesMCP Server (
src/index.ts
): Exposesget_shortcuts
tool via MCP protocol
The server filters shortcuts by OS/desktop/app, then passes relevant data + user query to Claude Opus for intelligent matching.
License
MIT
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables intelligent querying of keyboard shortcuts for various operating systems, desktop environments, and applications using natural language. Supports multi-platform shortcuts including system functions, desktop apps like Firefox and VS Code, and CLI tools like tmux and vim.