Enables Claude Code to control vim, allowing automated editing, testing, and navigation within the Vim editor.
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., "@PTY Debug MCP Server Spawn a vim session, type 'Hello World', and save."
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.
MCP server for debugging PTY/TTY/TUI programs. Enables Claude Code to spawn, interact with, and capture screen output from any terminal-based program.
This MCP server allows Claude Code to control Claude Code itself, vim, top, and other TUI programs. This enables:
Automated TUI testing
Debugging terminal applications
Screen scraping from interactive programs
CI/CD integration for TUI apps
1. spawn_session({ command: "claude" })
2. send_input({ specialKey: "shift+tab" }) // cycle modes
3. send_input({ input: "what is 1+1?" })
4. send_input({ specialKey: "enter" })
5. get_snapshot() // see Claude's response1. spawn_session({ command: "vim", args: ["test.txt"] })
2. send_input({ input: "i" }) // enter INSERT mode
3. send_input({ input: "Hello World!" }) // type text
4. send_input({ specialKey: "escape" }) // exit INSERT mode
5. send_input({ input: ":wq" }) // save command
6. send_input({ specialKey: "enter" }) // executeRelated MCP server: PTY MCP Server
claude mcp add pty-debug -- npx -y @so2liu/pty-mcp-server@latestAdd to claude_desktop_config.json:
{
"mcpServers": {
"pty-debug": {
"command": "npx",
"args": ["-y", "@so2liu/pty-mcp-server@latest"]
}
}
}Add to VS Code settings or .vscode/mcp.json:
{
"mcpServers": {
"pty-debug": {
"command": "npx",
"args": ["-y", "@so2liu/pty-mcp-server@latest"]
}
}
}Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"pty-debug": {
"command": "npx",
"args": ["-y", "@so2liu/pty-mcp-server@latest"]
}
}
}Add to Cline MCP settings:
{
"mcpServers": {
"pty-debug": {
"command": "npx",
"args": ["-y", "@so2liu/pty-mcp-server@latest"]
}
}
}gemini mcp add pty-debug -- npx -y @so2liu/pty-mcp-server@latestcodex mcp add pty-debug -- npx -y @so2liu/pty-mcp-server@latestTool | Description |
| Start a TUI program in a PTY |
| Send text or special keys |
| Capture current screen state |
| Change terminal dimensions |
| List active sessions |
| Terminate a session |
Supports all common shortcuts:
Basic: enter, tab, shift+tab, escape, backspace, delete
Arrows: up, down, left, right
With modifiers: shift+up, ctrl+right, alt+left, etc.
Control: ctrl+a to ctrl+z
Alt: alt+a to alt+z
Function: f1 to f12
Navigation: home, end, pageup, pagedown
-------------------------------------------------------------------------------------
1 |Processes: 643 total, 3 running, 640 sleeping 17:57:23 |
2 |Load Avg: 2.38, 2.75, 2.88 CPU usage: 13.13% user, 4.49% sys |
3 |... |
-------------------------------------------------------------------------------------# Install dependencies
bun install
# Development mode
bun run dev
# Build
bun run build
# Lint
bun run lintNode.js (runtime)
TypeScript
node-pty (PTY spawning)
@xterm/headless (terminal emulation)
@modelcontextprotocol/sdk (MCP server)
Releases are automatically published to npm via GitHub Actions.
Create npm granular token at https://www.npmjs.com/settings/tokens/granular-access-tokens/new
Expiration: 90 days
Packages: @so2liu/pty-mcp-server
Permissions: Read and write
Add NPM_TOKEN secret at https://github.com/so2liu/pty-mcp/settings/secrets/actions
Set calendar reminder to rotate token every 90 days
Update version in package.json
Create a GitHub release with tag (e.g., v1.0.1)
GitHub Actions will automatically publish to npm
MIT
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Live browser debugging for AI assistants — DOM, console, network via MCP.
Automate cloud browsers to navigate websites, interact with elements, and extract structured data.…
Capture screenshots, detect visual regressions between page versions, and analyze with AI.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/so2liu/pty-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server