ghostty-config-mcp
MCP server for managing Ghostty terminal emulator configuration.
Works with Claude Code and any MCP-compatible client.
Tools
| Tool | Description |
|---|---|
ghostty_version | Show installed Ghostty version and build info |
ghostty_search_config_docs | Search config documentation by keyword |
ghostty_get_config_option | Get full docs for a specific config key (supports fuzzy matching) |
ghostty_show_current_config | Show active configuration (optionally changes only) |
ghostty_validate_config | Validate config file for syntax errors |
ghostty_list_fonts | List available font families and faces |
ghostty_list_themes | List available themes (filterable by dark/light) |
ghostty_list_actions | List actions bindable to keybindings |
ghostty_list_keybinds | List current keybindings |
ghostty_list_colors | List named colors |
ghostty_show_face | Show which font face renders specific characters |
Requirements
Setup
As a Claude Code Plugin (Recommended)
See ghostty-config-plugin for one-command installation.
Standalone MCP Server
git clone https://github.com/shyuan/ghostty-config-mcp.git
cd ghostty-config-mcp
bun install
bun run buildAdd to .mcp.json in your project directory:
{
"mcpServers": {
"ghostty-config": {
"command": "node",
"args": ["/path/to/ghostty-config-mcp/dist/index.js"]
}
}
}Architecture
src/
├── index.ts # MCP server entry point (StdioServerTransport)
├── lib/
│ ├── exec.ts # node:child_process wrapper for ghostty CLI
│ └── parsers.ts # CLI output parsers (8 parsers)
└── tools/ # One file per tool (11 tools)- Config docs are cached in-memory keyed by Ghostty version (~120 KB, shared by search and get tools)
- All CLI execution goes through
exec.tswith a 10s default timeout - Uses
node:child_processfor Bun + Node.js dual compatibility - Never writes to
process.stdout(reserved for MCP stdio transport)
License
MIT
ghostty-config-mcp（中文說明）
用於管理 Ghostty 終端模擬器設定的 MCP server。
可搭配 Claude Code 或任何支援 MCP 的用戶端使用。
提供的工具
| 工具 | 說明 |
|---|---|
ghostty_version | 顯示 Ghostty 版本與建置資訊 |
ghostty_search_config_docs | 用關鍵字搜尋設定文件 |
ghostty_get_config_option | 取得特定設定項的完整文件（支援模糊匹配） |
ghostty_show_current_config | 顯示目前生效的設定（可只看修改項） |
ghostty_validate_config | 驗證設定檔語法 |
ghostty_list_fonts | 列出可用字型家族與字面 |
ghostty_list_themes | 列出可用主題（可篩選深色/淺色） |
ghostty_list_actions | 列出可綁定至快捷鍵的動作 |
ghostty_list_keybinds | 列出目前快捷鍵綁定 |
ghostty_list_colors | 列出具名顏色 |
ghostty_show_face | 查詢特定字元使用的渲染字型 |
環境需求
安裝方式
作為 Claude Code Plugin 安裝（推薦）
請參考 ghostty-config-plugin，一行指令即可安裝。
獨立 MCP Server
git clone https://github.com/shyuan/ghostty-config-mcp.git
cd ghostty-config-mcp
bun install
bun run build在專案目錄的 .mcp.json 中加入：
{
"mcpServers": {
"ghostty-config": {
"command": "node",
"args": ["/path/to/ghostty-config-mcp/dist/index.js"]
}
}
}授權條款
MIT