{"id":23086034,"url":"https://github.com/g0t4/mcp-server-commands","last_synced_at":"2025-04-09T18:16:15.619Z","repository":{"id":265357009,"uuid":"895838922","full_name":"g0t4/mcp-server-commands","owner":"g0t4","description":"Model Context Protocol server to run commands","archived":false,"fork":false,"pushed_at":"2024-12-21T05:03:20.000Z","size":190,"stargazers_count":99,"open_issues_count":5,"forks_count":20,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-09T18:16:11.581Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/g0t4.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-29T02:39:02.000Z","updated_at":"2025-04-05T07:07:43.000Z","dependencies_parsed_at":"2024-11-29T03:31:52.801Z","dependency_job_id":"9f78e625-162d-4127-a3f0-aea23272cef2","html_url":"https://github.com/g0t4/mcp-server-commands","commit_stats":null,"previous_names":["g0t4/mcp-server-commands"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/g0t4%2Fmcp-server-commands","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/g0t4%2Fmcp-server-commands/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/g0t4%2Fmcp-server-commands/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/g0t4%2Fmcp-server-commands/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/g0t4","download_url":"https://codeload.github.com/g0t4/mcp-server-commands/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248085322,"owners_count":21045139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-16T18:15:10.204Z","updated_at":"2025-04-09T18:16:15.601Z","avatar_url":"https://github.com/g0t4.png","language":"JavaScript","funding_links":[],"categories":["Cloud Infrastructure","CLI Tools","Code Execution \u0026 Automation MCP Servers","📚 Projects (1974 total)","MCP 服务器精选列表","Legend","Command Line","サーバー実装","MCP Servers","Uncategorized","カテゴリ","💻 Operating Systems \u0026 Command Line","Code Execution","🌐 Web Development","Table of Contents","Server Implementations","⚔️ Weaponization \u0026 Exploitation"],"sub_categories":["🖥️ Command Line","Playwright","MCP Servers","🖥️ 命令行与 Shell 交互","🖥️ \u003ca name=\"command-line\"\u003e\u003c/a\u003eCommand Line","🖥️ \u003ca name=\"command-line\"\u003e\u003c/a\u003eコマンドライン","How to Submit","Uncategorized","⚙️ \u003ca name=\"system-administration\"\u003e\u003c/a\u003eシステム管理","AI Services","Command Line"],"readme":"## Tools\n\nTools are for LLMs to request, i.e. Claude Desktop app. Claude Sonnet 3.5 intelligently uses both tools, I was pleasantly surprised.\n\n- `run_command` - run a command, i.e. `hostname` or `ls -al` or `echo \"hello world\"` etc\n  - Returns STDOUT and STDERR as text\n- `run_script` - run a script! (i.e. `fish`, `bash`, `zsh`, `python`)\n  - Let your LLM run the code it writes!\n  - script is passed over STDIN\n  - `run_script` == `run_command` + script over STDIN\n  - Claude has been pretty creative with this, i.e. using `cat` as the interpreter to create new files!\n\n\u003e [!WARNING]\n\u003e Be careful what you ask this server to run!\n\u003e In Claude Desktop app, use `Approve Once` (not `Allow for This Chat`) so you can review each command, use `Deny` if you don't trust the command.\n\u003e Permissions are dictated by the user that runs the server.\n\u003e DO NOT run with `sudo`.\n\n## Video walkthrough\n\n\u003ca href=\"https://youtu.be/0-VPu1Pc18w\"\u003e\u003cimg src=\"https://img.youtube.com/vi/0-VPu1Pc18w/maxresdefault.jpg\" width=\"480\" alt=\"YouTube Thumbnail\"\u003e\u003c/a\u003e\n\n## Prompts\n\nPrompts are for users to include in chat history, i.e. via `Zed`'s slash commands (in its AI Chat panel)\n\n- `run_command` - generate a prompt message with the command output\n\n## Development\n\nInstall dependencies:\n```bash\nnpm install\n```\n\nBuild the server:\n```bash\nnpm run build\n```\n\nFor development with auto-rebuild:\n```bash\nnpm run watch\n```\n\n## Installation\n\nTo use with Claude Desktop, add the server config:\n\nOn MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\nOn Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n\n### Use the published npm package\n\nPublished to npm as [mcp-server-commands](https://www.npmjs.com/package/mcp-server-commands) using this [workflow](https://github.com/g0t4/mcp-server-commands/actions)\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-server-commands\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-server-commands\"]\n    }\n  }\n}\n```\n\n### Use a local build (repo checkout)\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-server-commands\": {\n      // works b/c of shebang in index.js\n      \"command\": \"/path/to/mcp-server-commands/build/index.js\"\n    }\n  }\n}\n```\n\n### Logging\n\nClaude Desktop app writes logs to `~/Library/Logs/Claude/mcp-server-mcp-server-commands.log`\n\nBy default, only important messages are logged (i.e. errors).\nIf you want to see more messages, add `--verbose` to the `args` when configuring the server.\n\nBy the way, logs are written to `STDERR` because that is what Claude Desktop routes to the log files.\nIn the future, I expect well formatted log messages to be written over the `STDIO` transport to the MCP client (note: not Claude Desktop app).\n\n### Debugging\n\nSince MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:\n\n```bash\nnpm run inspector\n```\n\nThe Inspector will provide a URL to access debugging tools in your browser.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fg0t4%2Fmcp-server-commands","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fg0t4%2Fmcp-server-commands","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fg0t4%2Fmcp-server-commands/lists"}