Shell Use
Rank #50,382io.github.kyuheon-kr/shell-use
MCP server providing shell-use capabilities
Shell Use is a Model Context Protocol (MCP) server published by kyuheon-kr. It ranks #50,382 of 137,492 servers tracked on MCP Toplist. Shell Use is listed across 2 registries — Official MCP and Glama, with 2 tracked versions. It was first listed on Jan 13, 2026 and most recently updated on Jan 13, 2026.
Ranks ahead of 87,110 of 137,492 servers on MCP Toplist.
Use Shell Use
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add shell-use -e "SHELL_USE_SESSIONS=<your SHELL_USE_SESSIONS>" -e "SHELL_USE_SOCKET=<your SHELL_USE_SOCKET>" -- docker run -i --rm ghcr.io/kyuheon-kr/shell-use:1.0.0Replace each placeholder with your own value before saving.
[mcp_servers.shell-use]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/kyuheon-kr/shell-use:1.0.0"]
[mcp_servers.shell-use.env]
SHELL_USE_SESSIONS = "<your SHELL_USE_SESSIONS>"
SHELL_USE_SOCKET = "<your SHELL_USE_SOCKET>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"shell-use": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kyuheon-kr/shell-use:1.0.0"
],
"env": {
"SHELL_USE_SESSIONS": "<your SHELL_USE_SESSIONS>",
"SHELL_USE_SOCKET": "<your SHELL_USE_SOCKET>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"shell-use": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kyuheon-kr/shell-use:1.0.0"
],
"env": {
"SHELL_USE_SESSIONS": "<your SHELL_USE_SESSIONS>",
"SHELL_USE_SOCKET": "<your SHELL_USE_SOCKET>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"shell-use": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kyuheon-kr/shell-use:1.0.0"
],
"env": {
"SHELL_USE_SESSIONS": "<your SHELL_USE_SESSIONS>",
"SHELL_USE_SOCKET": "<your SHELL_USE_SOCKET>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"shell-use": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kyuheon-kr/shell-use:1.0.0"
],
"env": {
"SHELL_USE_SESSIONS": "<your SHELL_USE_SESSIONS>",
"SHELL_USE_SOCKET": "<your SHELL_USE_SOCKET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"shell-use": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kyuheon-kr/shell-use:1.0.0"
],
"env": {
"SHELL_USE_SESSIONS": "<your SHELL_USE_SESSIONS>",
"SHELL_USE_SOCKET": "<your SHELL_USE_SOCKET>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.kyuheon-kr%2Fshell-use)<a href="https://mcptoplist.com/server/io.github.kyuheon-kr%2Fshell-use"><img src="https://mcptoplist.com/badge/io.github.kyuheon-kr%2Fshell-use.svg" alt="MCP Toplist: Top 50% of 137,492" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 2 registries
kyuheon-kr
Available versions (2)
| Version | Published |
|---|---|
| 1.0.0 | Jan 13, 2026 |
| 0.1.0 | Nov 25, 2024 |
Frequently asked questions
- Who maintains Shell Use?
- Shell Use is maintained by kyuheon-kr, which publishes 1 MCP server (2 total versions) tracked on MCP Toplist.
- Is Shell Use listed on the Official MCP Registry?
- Yes — Shell Use is listed on the Official MCP Registry, alongside Glama.
- How many versions does Shell Use have?
- MCP Toplist tracks 2 versions of Shell Use, most recently published on Jan 13, 2026.
- Where can I find the source code for Shell Use?
- The source code for Shell Use is hosted at github.com/kyuheon-kr/shell-use.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.