{"_id":"@darenft-labs/mcp-server-run-command","_rev":"4-8a24e3119035cc3a9912d7043859ee76","name":"@darenft-labs/mcp-server-run-command","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@darenft-labs/mcp-server-run-command","version":"1.0.0","keywords":["mcp","server","run","command"],"author":{"name":"annguyen-darenft"},"license":"MIT","_id":"@darenft-labs/mcp-server-run-command@1.0.0","maintainers":[{"name":"thomasdare","email":"thomas.nguyen@darenft.com"},{"name":"annguyen-darenft","email":"an.nguyen@derachain.com"},{"name":"duc.vu.derachain","email":"duc.vu@derachain.com"}],"homepage":"https://github.com/darenft-labs/mcp-server-run-command#readme","bugs":{"url":"https://github.com/darenft-labs/mcp-server-run-command/issues"},"bin":{"mcp-server-run-command":"build/index.js"},"dist":{"shasum":"eccc6a7efbfc8f37a4765c351b061cc878c54675","tarball":"https://registry.npmjs.org/@darenft-labs/mcp-server-run-command/-/mcp-server-run-command-1.0.0.tgz","fileCount":10,"integrity":"sha512-n+/YpfmU0Q7MpayGUj26so8RG3rfos6dJOzpJ8P7nWdzfQp/zoWxqiY0IrgVLdOSV96nJUKLsRurP7alog8SKQ==","signatures":[{"sig":"MEQCICQnFbFB4g496Zi9ZiQD70dY+tMsmC04oXFUDaJe5OseAiBS0v87kbjkiwQFLJnoENO/rGMICcHKquZXqFTLXBgHbA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23030},"main":"./build/index.js","type":"module","gitHead":"1386175de7cd5209bfa582b45b4f51115cedccdc","private":false,"scripts":{"test":"jest","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","clean":"rm -rf build","watch":"npm run build && tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector build/index.js","test:watch":"jest --watch","test:integration":"jest tests/integration"},"_npmUser":{"name":"annguyen-darenft","email":"an.nguyen@derachain.com"},"repository":{"url":"git+https://github.com/darenft-labs/mcp-server-run-command.git","type":"git"},"_npmVersion":"10.9.2","description":"An MCP server to run arbitrary commands","directories":{"test":"tests"},"_nodeVersion":"22.16.0","dependencies":{"@modelcontextprotocol/sdk":"1.9.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.3.2","typescript":"^5.8.3","@types/jest":"^29.5.14","@types/node":"^22.14.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-run-command_1.0.0_1749199948216_0.9840208400605921","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@darenft-labs/mcp-server-run-command","version":"1.0.1","keywords":["mcp","server","run","command"],"author":{"name":"annguyen-darenft"},"license":"MIT","_id":"@darenft-labs/mcp-server-run-command@1.0.1","maintainers":[{"name":"thomasdare","email":"thomas.nguyen@darenft.com"},{"name":"annguyen-darenft","email":"an.nguyen@derachain.com"},{"name":"duc.vu.derachain","email":"duc.vu@derachain.com"}],"homepage":"https://github.com/darenft-labs/mcp-server-run-command#readme","bugs":{"url":"https://github.com/darenft-labs/mcp-server-run-command/issues"},"bin":{"mcp-server-run-command":"build/index.js"},"dist":{"shasum":"210946116957072aa2cfb70384d787bbf7df7f6c","tarball":"https://registry.npmjs.org/@darenft-labs/mcp-server-run-command/-/mcp-server-run-command-1.0.1.tgz","fileCount":10,"integrity":"sha512-KWCIG87dQud9HR9SrHQo1S4p/rZcf2rqNIPOqoy1Te+xgsVg8s7HAYB6PzPdAWcM8Lrg9EDfaMgMARkZPa88Bw==","signatures":[{"sig":"MEYCIQDG5W5IWIx06HKmUGovD2BJF63ChTH1KC18ndcWD/iT2wIhANFLQnENjo2NpwxDdhNPOya+rKCUS0SCS624cFK9TmnE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24407},"main":"./build/index.js","type":"module","gitHead":"f6712017b6248fd8d148b3bb59ad36b1e333641d","private":false,"scripts":{"test":"jest","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","clean":"rm -rf build","watch":"npm run build && tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector build/index.js","test:watch":"jest --watch","test:integration":"jest tests/integration"},"_npmUser":{"name":"annguyen-darenft","email":"an.nguyen@derachain.com"},"repository":{"url":"git+https://github.com/darenft-labs/mcp-server-run-command.git","type":"git"},"_npmVersion":"10.9.2","description":"An MCP server to run arbitrary commands","directories":{"test":"tests"},"_nodeVersion":"22.16.0","dependencies":{"@modelcontextprotocol/sdk":"1.9.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.3.2","typescript":"^5.8.3","@types/jest":"^29.5.14","@types/node":"^22.14.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-run-command_1.0.1_1749457731226_0.7601088786981287","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@darenft-labs/mcp-server-run-command","version":"1.0.2","keywords":["mcp","server","run","command"],"author":{"name":"annguyen-darenft"},"license":"MIT","_id":"@darenft-labs/mcp-server-run-command@1.0.2","maintainers":[{"name":"thomasdare","email":"thomas.nguyen@darenft.com"},{"name":"annguyen-darenft","email":"an.nguyen@derachain.com"},{"name":"duc.vu.derachain","email":"duc.vu@derachain.com"}],"homepage":"https://github.com/darenft-labs/mcp-server-run-command#readme","bugs":{"url":"https://github.com/darenft-labs/mcp-server-run-command/issues"},"bin":{"mcp-server-run-command":"build/index.js"},"dist":{"shasum":"256a4031825c3b8c766e6f0a384e28534bff118a","tarball":"https://registry.npmjs.org/@darenft-labs/mcp-server-run-command/-/mcp-server-run-command-1.0.2.tgz","fileCount":10,"integrity":"sha512-sFegbz05jsVcN0gibLUI4fxkeGa+Whnxvx+XJKCretWaKZXx7G+zJWRmN02asUJAfd/sgh+P9wiazrFGtQAQmA==","signatures":[{"sig":"MEUCICC3MbIo2xOMa2deyY+SW54v+pRMVbO3B0BTTD3VpIjmAiEAzQbglkZzEMRfRZ44HTStZzx4XPQUgo+kqeoovHCNlkM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24405},"main":"./build/index.js","type":"module","gitHead":"30ab391d805042983332543cc36b271a7fd8aa9b","private":false,"scripts":{"test":"jest","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","clean":"rm -rf build","watch":"npm run build && tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector build/index.js","test:watch":"jest --watch","test:integration":"jest tests/integration"},"_npmUser":{"name":"annguyen-darenft","email":"an.nguyen@derachain.com"},"repository":{"url":"git+https://github.com/darenft-labs/mcp-server-run-command.git","type":"git"},"_npmVersion":"10.9.2","description":"An MCP server to run arbitrary commands","directories":{"test":"tests"},"_nodeVersion":"22.16.0","dependencies":{"@modelcontextprotocol/sdk":"1.9.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.3.2","typescript":"^5.8.3","@types/jest":"^29.5.14","@types/node":"^22.14.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-run-command_1.0.2_1749458652455_0.39305605802449217","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@darenft-labs/mcp-server-run-command","version":"1.0.3","description":"An MCP server to run arbitrary commands","private":false,"type":"module","bin":{"mcp-server-run-command":"build/index.js"},"scripts":{"clean":"rm -rf build","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","prepare":"npm run build","watch":"npm run build && tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js","test":"jest","test:watch":"jest --watch","test:integration":"jest tests/integration"},"dependencies":{"@modelcontextprotocol/sdk":"1.9.0"},"devDependencies":{"@types/jest":"^29.5.14","@types/node":"^22.14.1","jest":"^29.7.0","ts-jest":"^29.3.2","typescript":"^5.8.3"},"main":"./build/index.js","directories":{"test":"tests"},"repository":{"type":"git","url":"git+https://github.com/darenft-labs/mcp-server-run-command.git"},"keywords":["mcp","server","run","command"],"author":{"name":"annguyen-darenft"},"license":"MIT","bugs":{"url":"https://github.com/darenft-labs/mcp-server-run-command/issues"},"homepage":"https://github.com/darenft-labs/mcp-server-run-command#readme","_id":"@darenft-labs/mcp-server-run-command@1.0.3","gitHead":"b35ecefd72c925efc442f61c0b5d4443a769b2aa","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-5VRRbDSY820ld/4pCnr64O51Lg0hJRaknLGIETRkCXJb7Gv6fHBMDhUjHxo2nb7SHF79tA781KJycfFmkOB6/g==","shasum":"9062a242ea75838043aa9436d4c3ec1d35c7b0fb","tarball":"https://registry.npmjs.org/@darenft-labs/mcp-server-run-command/-/mcp-server-run-command-1.0.3.tgz","fileCount":10,"unpackedSize":24403,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDr8ntjQLMgyKKAwIxwTlgvQj8yMvCBPrwmTGXDCG28sAIhAPvOOtjHYVSlZyWh6vwR3KVylHJ/zsxtAy9dhTI9mXhB"}]},"_npmUser":{"name":"annguyen-darenft","email":"an.nguyen@derachain.com"},"maintainers":[{"name":"thomasdare","email":"thomas.nguyen@darenft.com"},{"name":"annguyen-darenft","email":"an.nguyen@derachain.com"},{"name":"duc.vu.derachain","email":"duc.vu@derachain.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-run-command_1.0.3_1749459135566_0.45739816572967973"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-06T08:52:28.082Z","modified":"2025-06-09T08:52:16.055Z","1.0.0":"2025-06-06T08:52:28.387Z","1.0.1":"2025-06-09T08:28:51.390Z","1.0.2":"2025-06-09T08:44:12.667Z","1.0.3":"2025-06-09T08:52:15.793Z"},"bugs":{"url":"https://github.com/darenft-labs/mcp-server-run-command/issues"},"author":{"name":"annguyen-darenft"},"license":"MIT","homepage":"https://github.com/darenft-labs/mcp-server-run-command#readme","keywords":["mcp","server","run","command"],"repository":{"type":"git","url":"git+https://github.com/darenft-labs/mcp-server-run-command.git"},"description":"An MCP server to run arbitrary commands","maintainers":[{"name":"thomasdare","email":"thomas.nguyen@darenft.com"},{"name":"annguyen-darenft","email":"an.nguyen@derachain.com"},{"name":"duc.vu.derachain","email":"duc.vu@derachain.com"}],"readme":"## Tools\r\n\r\nTools are for LLMs to request. Claude Sonnet 3.5 intelligently uses `run_command`. And, initial testing shows promising results with [Groq Desktop with MCP](https://github.com/groq/groq-desktop-beta) and `llama4` models.\r\n\r\nCurrently, just one command to rule them all!\r\n\r\n- `run_command` - run a command, i.e. `hostname` or `ls -al` or `echo \"hello world\"` etc\r\n  - Returns `STDOUT` and `STDERR` as text\r\n  - Optional `stdin` parameter means your LLM can\r\n    - pass code in `stdin` to commands like `fish`, `bash`, `zsh`, `python`\r\n    - create files with `cat >> foo/bar.txt` from the text in `stdin`\r\n\r\n> [!WARNING]\r\n> Be careful what you ask this server to run!\r\n> 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.\r\n> Permissions are dictated by the user that runs the server.\r\n> DO NOT run with `sudo`.\r\n\r\n### Python Tools (Extends)\r\n\r\n- `list_python_packages` - List installed Python packages\r\n  - Returns a list of installed Python packages with their versions\r\n  - Useful for checking what packages are available in the environment\r\n\r\n- `install_python_packages` - Install Python packages using pip\r\n  - Takes a list of package names to install (separate by space)\r\n  - Returns the installation output showing success/failure\r\n\r\n- `run_python_script` - Execute a Python script\r\n  - Takes Python file path as input and runs it\r\n  - Returns the script output (stdout/stderr)\r\n  - Can import installed packages and use Python standard library\r\n  - Useful for data processing, calculations, and automation tasks\r\n\r\n## Prompts\r\n\r\nPrompts are for users to include in chat history, i.e. via `Zed`'s slash commands (in its AI Chat panel)\r\n\r\n- `run_command` - generate a prompt message with the command output\r\n\r\n## Development\r\n\r\nInstall dependencies:\r\n```bash\r\nnpm install\r\n```\r\n\r\nBuild the server:\r\n```bash\r\nnpm run build\r\n```\r\n\r\nFor development with auto-rebuild:\r\n```bash\r\nnpm run watch\r\n```\r\n\r\n## Installation\r\n\r\nTo use with Claude Desktop, add the server config:\r\n\r\nOn MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\r\nOn Windows: `%APPDATA%/Claude/claude_desktop_config.json`\r\n\r\nGroq Desktop (beta, macOS) uses `~/Library/Application Support/groq-desktop-app/settings.json`\r\n\r\n### Use the published npm package\r\n\r\nPublished to npm as [@darenft-labs/mcp-server-run-command](https://www.npmjs.com/package/@darenft-labs/mcp-server-run-command)\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mcp-server-run-commands\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"-y\",\r\n        \"@darenft-labs/mcp-server-run-command\"\r\n      ]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Use a local build (repo checkout)\r\n\r\nMake sure to run `npm run build`\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mcp-server-run-commands\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"/path/to/mcp-server-run-commands/build/index.js\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Logging\r\n\r\nClaude Desktop app writes logs to `~/Library/Logs/Claude/mcp-server-mcp-server-run-commands.log`\r\n\r\nBy default, only important messages are logged (i.e. errors).\r\nIf you want to see more messages, add `--verbose` to the `args` when configuring the server.\r\n\r\nBy the way, logs are written to `STDERR` because that is what Claude Desktop routes to the log files.\r\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).\r\n\r\n### Debugging\r\n\r\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:\r\n\r\n```bash\r\nnpx -y @modelcontextprotocol/inspector\r\n```\r\n\r\nThe Inspector will provide a URL to access debugging tools in your browser.\r\n","readmeFilename":"README.md"}