AI导哈

命令行代理服务

一个最小化的模型上下文协议（MCP）服务器，提供运行Windows cmd.exe命令的工具，适用于AI客户端与Windows命令提示符交互。

  • by guangxiangdebizi
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 guangxiangdebizi/CMD-MCP

使用说明

cmd-mcp 可以翻译为“命令-多协议转换器”或根据具体上下文简化为“命令与多协议转换”。不过，“cmd-mcp”作为一个特定术语或缩写，其准确翻译可能需要依据其在特定领域或技术背景中的定义。在这里，我给出了一个较为通用的翻译

一个提供单一工具以运行Windows的最小模型上下文协议（MCP）服务器 cmd.exe 命令。它设计得简洁明了：一个工具，一个符合JSON模式的匹配器，以及一个STDIO传输方式，这样您的AI客户端就可以以尽可能少的仪式感与Windows命令提示符进行交互。

要求

  • Node.js 18及以上版本
  • pnpm、npm 或 yarn
  • Windows 主机（该工具封装 cmd.exe)

安装

npm install

使用方法

通过STDIO构建并运行（对于将服务器作为子进程启动的MCP运行时，这是预期的传输方式）：

npm run build
npm start

为了快速迭代，您可以直接从TypeScript运行：

npm run dev

MCP客户端配置

将您的MCP兼容客户端指向编译后的入口点（node dist/index.js) 使用 stdio 运输。示例（Anthropic的Claude桌面版格式）：

{
  "mcpServers": {
    "cmd-mcp": {
      "command": "node",
      "args": ["C:/path/to/cmd-mcp/dist/index.js"],
      "transport": "stdio"
    }
  }
}

工具签名

cmd.run

字段 类型 是否必需 描述
（横线） （横线） （横线） （内容）
. cwd
字符串 ✖ 进程的工作目录。 timeoutMs

| 整数 | ✖ | 在经过这么多毫秒后终止进程（默认60000毫秒）。 |

该工具返回一个包含退出代码、标准输出和标准错误输出的文本块。非零退出代码表示结果对客户端而言是一个错误。

  • 安全注意事项 cmd.exe这个服务器是一个轻量级的代理服务器，用于 ; 它确实如此 不是
  • 沙盒或验证命令。
  • 仅在受信任的环境中运行，并且仅与您控制的客户端进行交互。 timeoutMs 使用

以防范长时间运行或挂起的进程。

出版 package.json 这个（或“该”） files 已经包含 main 并且

npm run build
npm publish

字段已准备就绪，可随时发布。当您准备好发布时：

  • 联系
  • 领英（LinkedIn）：https://www.linkedin.com/in/xingyu-chen-b5b3b0313/
  • 电子邮箱：guangxiangdebizi@gmail.com
  • GitHub地址：https://github.com/guangxiangdebizi/

npm: https://www.npmjs.com/~xingyuchen（中文翻译为：“npm：https://www.npmjs.com/~xingyuchen”）

许可证

相关 MCP