使用说明
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 build
Add 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
