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
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Keyboard Shortcuts MCP Serverhow do I switch between tabs in Firefox on Ubuntu?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
# Install dependencies
pnpm install
# Build the server
pnpm buildConfiguration
Set your Anthropic API key as an environment variable:
export ANTHROPIC_API_KEY="your-api-key-here"Usage
Running Standalone
pnpm startIntegrating with Claude Desktop
Add to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"keyboard-shortcuts": {
"command": "node",
"args": ["/path/to/keyboard-shortcuts-mcp/dist/index.js"],
"env": {
"ANTHROPIC_API_KEY": "your-api-key-here"
}
}
}
}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
// Query tmux shortcuts (no desktop needed for CLI tools)
{
"os": "ubuntu",
"application": "tmux",
"query": "how do I split a pane vertically?"
}
// Query Firefox shortcuts on GNOME
{
"os": "ubuntu",
"desktop": "gnome",
"application": "firefox",
"query": "how to open a new private window"
}
// Query GNOME window management
{
"os": "ubuntu",
"desktop": "gnome",
"query": "tile window to left half of screen"
}Data Structure
Shortcuts are organized as:
data/
└── ubuntu/
├── desktops/
│ └── gnome/
│ ├── window-management.json
│ ├── system-functions.json
│ └── ...
├── apps/
│ ├── browser/
│ │ ├── firefox.json
│ │ └── chrome.json
│ ├── editor/
│ │ ├── vscode.json
│ │ └── vim.json
│ └── ...
└── tools/
├── tmux.json
├── vim.json
└── ...Each JSON file contains:
{
"os": "ubuntu",
"desktop": "gnome" | null,
"application": "firefox" | null,
"file": "firefox",
"categories": [
{
"name": "Tab Management",
"shortcuts": [
{
"keys": "Ctrl + T",
"description": "New tab"
}
]
}
]
}Development
# Watch mode (auto-reload on changes)
pnpm dev
# Build TypeScript
pnpm build
# Run built server
pnpm startArchitecture
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_shortcutstool 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