Tools

基本能力

产品定位

mcp-server-run-command 是一个为LLMs设计的工具服务器，用于执行系统命令和Python脚本，支持与Claude和Groq Desktop等工具集成。

核心功能

1. 命令执行：通过run_command运行系统命令，支持stdin输入，返回STDOUT和STDERR。
2. Python工具扩展：
   • list_python_packages：列出已安装的Python包及其版本。
   • install_python_packages：通过pip安装Python包。
   • run_python_script：执行Python脚本并返回输出。

适用场景

1. 自动化执行系统命令（如文件操作、环境检查等）。
2. 管理和安装Python包。
3. 运行Python脚本进行数据处理或自动化任务。
4. 与LLM工具（如Claude、Groq Desktop）集成，扩展其功能。

使用教程

使用依赖

安装Node.js和npm。

安装教程

1. 安装依赖：
   复制

   npm install
   

2. 构建服务器：
   复制

   npm run build
   

3. 开发时自动重建：
   复制

   npm run watch
   

配置服务器

1. 使用npm包：
   复制

   {
     "mcpServers": {
       "mcp-server-run-commands": {
         "command": "npx",
         "args": [
           "-y",
           "@darenft-labs/mcp-server-run-command"
         ]
       }
     }
   }
   

2. 使用本地构建：
   复制

   {
     "mcpServers": {
       "mcp-server-run-commands": {
         "command": "node",
         "args": ["/path/to/mcp-server-run-commands/build/index.js"]
       }
     }
   }
   

调试方式

1. 使用MCP Inspector调试：
   复制

   npx -y @modelcontextprotocol/inspector
   

2. 查看日志：
   • 默认日志路径：~/Library/Logs/Claude/mcp-server-mcp-server-run-commands.log
   • 启用详细日志：在配置中添加--verbose参数。

常见问题解答

1. 安全性问题：
   • 不要以sudo权限运行服务器。
   • 在Claude Desktop中使用Approve Once选项，逐条审核命令。
2. 日志问题：
   • 日志默认写入STDERR，可通过--verbose启用详细日志。
3. 调试问题：
   • 使用MCP Inspector进行调试，获取浏览器调试工具。