cmd-line-executor MCP server

cmd-line-executor MCP server

用于执行命令行命令的实验性MCP Server。

概述

cmd-line-executor 是一个 MCP 服务器,允许 Claude 执行命令行命令。它提供了一个工具 run_command,可接受 cmdargs 参数来执行命令行指令。

安装配置

Claude 桌面版配置

  1. 找到配置文件位置:

    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json
  2. 添加服务器配置:

"mcpServers": {
  "cmd-line-executor": {
    "command": "uvx",
    "args": [
      "cmd-line-executor"
    ]
  }
}

开发环境使用以下配置:

"mcpServers": {
  "cmd-line-executor": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/$(whoami)/experiments/claude-mvp/cmd-line-executor",
      "run",
      "cmd-line-executor"
    ]
  }
}

使用方法

服务器提供 run_command 工具,可以执行命令行命令并返回结果,包括标准输出、标准错误和状态码。

开发指南

构建与发布

  1. 同步依赖:

    uv sync
    
  2. 构建包:

    uv build
    
  3. 发布到 PyPI:

    uv publish
    

    注意:需要设置 PyPI 凭证(通过 --token 或环境变量)

调试

推荐使用 MCP Inspector 进行调试:

npx @modelcontextprotocol/inspector uv --directory /path/to/cmd-line-executor run cmd-line-executor

启动后,在浏览器中访问提供的 URL 开始调试。