Skip to main content
Glama
shyuan

ghostty-config-mcp

by shyuan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

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

Related MCP server: interminal

Requirements

  • Ghostty installed and available in PATH

  • Node.js 18+ (or Bun for development)

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.ts with a 10s default timeout

  • Uses node:child_process for 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

查詢特定字元使用的渲染字型

環境需求

  • Ghostty 已安裝且在 PATH 中

  • Node.js 18+（開發用可改用 Bun）

安裝方式

作為 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-server-terminal

    aybelatchane
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server enabling AI agents to interact with terminal applications through structured Terminal State Tree representation. Works with any AI assistant that supports the Model Context Protocol.
    41 npm
    19
    MIT

  • interminal

    QiuwenZheng
    A
    license
    A
    quality
    A
    maintenance
    MCP server for SSH and local terminal access. Supports interactive commands, long-running processes, and TUI apps like tmux/zellij
    6
    3
    MIT

  • terminal-bridge-mcp

    dividduang
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that bridges AI assistants to real terminal sessions, enabling creation, management, and interaction with persistent PTY processes for running commands, monitoring output, and debugging.
    1
    MIT