mcp-teleport
A Model Context Protocol (MCP) server that enables AI assistants to interact with Teleport infrastructure through the tsh CLI.
claude mcp add --transport stdio giantswarm-mcp-teleport mcp-teleport serve
How to use
MCP Teleport exposes a standardized interface for AI assistants to interact with Teleport infrastructure. It provides tools to authenticate to Teleport clusters, manage SSH sessions, discover and access Kubernetes clusters, and (coming soon) access web applications through Teleport. The server supports multiple transports (stdio by default, plus web-friendly options like SSE and streamable HTTP) and offers dry-run and debug modes to help you test operations safely. Typical interactions involve listing available SSH nodes, logging into Teleport clusters, retrieving kubeconfig for clusters, and running commands on remote nodes via SSH. Integration with Claude Desktop or other MCP clients is demonstrated in the example configuration, showing how to point a client at the mcp-teleport server and issue commands like login, list, and SSH actions.
How to install
Prerequisites:
- Go 1.24+ (for building from source)
- Teleport CLI (tsh) installed and configured
- Access to an active Teleport cluster
Install Teleport CLI (examples):
macOS: brew install teleport
Linux (Ubuntu/Debian): curl -O https://get.gravitational.com/teleport-v15.1.0-linux-amd64-bin.tar.gz tar -xzf teleport-v15.1.0-linux-amd64-bin.tar.gz sudo mv teleport/tsh /usr/local/bin/
Verify installation: tsh version
Install the MCP Teleport server from source:
Clone the repository
git clone https://github.com/giantswarm/mcp-teleport.git cd mcp-teleport
Build
go build -o mcp-teleport
Optional: Install to PATH
sudo mv mcp-teleport /usr/local/bin/
Alternatively, install via Go
go install github.com/giantswarm/mcp-teleport@latest
Additional notes
Tips and considerations:
- Ensure tsh is configured to access your Teleport clusters before starting the MCP server.
- The server supports multiple transports; use --transport to choose between stdio, SSE, or streamable-http modes.
- Use --debug for verbose logging and --dry-run to simulate operations without affecting real state.
- For Claude Desktop integration, provide the mcpServers configuration with the command and arguments to start the server (see examples in the README).
- If you plan to run the server as a background service, consider using the Go build output or a pre-built binary and ensure the Teleport environment (tsh config, environment variables) is accessible to the process.
- The Application Access tools are listed as coming soon; keep an eye on releases for implementation and endpoints.
Related MCP Servers
mcp-language
mcp-language-server gives MCP enabled clients access semantic tools like get definition, references, rename, and diagnostics.
flux-operator
GitOps on Autopilot Mode
lingti-bot
🐕⚡ 「极简至上 效率为王 一次编译 到处执行 极速接入」的 AI Bot
kodit
👩💻 MCP server to index external repositories
github-brain
An experimental GitHub MCP server with local database.
bgg
BGG MCP provides access to BoardGameGeek and a variety of board game related data through the Model Context Protocol. Enabling retrieval and filtering of board game data, user collections, and profiles.