Wsl Windows Script Runner

MCP开发工具

提供方 dbbuilder

开发工具 未标注 无需鉴权 社区 / 第三方 Claude

WSL-Windows脚本运行器是一种桥接服务,允许WSL环境自动在Windows主机上执行Windows脚本(.bat、.ps1),并提供完整的日志记录和监控功能。适用于AI助手、自动化工作流和测试等场景。

一句话选型结论

按资料字段整理

Wsl Windows Script Runner 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

PowerShell本地部署WSL集成脚本执行自动化工具日志记录Windows-Linux桥接

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Wsl Windows Script Runner当前 未标注 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方dbbuilder上游标注的维护方 dbbuilder
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.0 KB
来自项目仓库与上游目录的原文,未做删改

WSL Windows脚本运行程序

一种桥接服务,允许WSL环境在Windows主机上自动执行Windows脚本(.bat、.ps1),并进行完整的日志记录和监控。

概述

此工具解决了从WSL(Linux的Windows子系统)运行Windows本机脚本的问题。它监视队列文件夹中的新脚本,在Windows上自动执行它们,捕获完整的输出日志,并组织完成的脚本。

非常适合:在WSL中运行的AI助手(如Claude)需要执行Windows命令、自动化工作流、测试或WSL需要触发Windows端操作的任何场景。

特性

  • 自动执行:放置在队列文件夹中的脚本会立即执行
  • 完整日志记录:使用时间戳完成stdout/stderr捕获
  • 文件稳定性检测:执行前等待文件完全写入
  • 有组织的产出:自动分类到已完成/存档文件夹
  • 退出代码跟踪:通过适当的日志记录进行成功/失败检测
  • 多种脚本类型:支持.ps1、.bat和.cmd文件
  • WSL集成:用于提交的易于使用的bash辅助脚本
  • 服务模式:作为Windows计划任务运行(从启动时开始)
  • 错误恢复:故障时自动重启
  • MCP集成:用于本机Claude Code集成的可选MCP服务器

集成选项

选项1:MCP服务器(建议用于Claude代码)⭐

MCP(模型上下文协议)服务器提供与专用工具的本地Claude集成:

  • windows_execute -通过一次工具调用执行PowerShell命令
  • windows_get_status -检查转轮状态
  • windows_list_logs -查看最近的日志
  • windows_read_log -读取特定日志文件

设置:```bash
cd /mnt/d/Dev2/wsl-windows-script-runner/mcp-server
./setup.sh
./configure-claude.sh


看 mcp服务器/README.md 获取完整文档。

**Claude中的用法:**```
Use windows_execute to get the Windows computer name
Use windows_execute to list all running Chrome processes
Check the Windows script runner status

选项2:Bash助手脚本

使用 wsl-submit.sh 直接使用辅助脚本:```bash
/mnt/d/Dev2/wsl-windows-script-runner/wsl-submit.sh script.ps1


此选项需要更多的手动步骤,但无需MCP设置即可工作。

## 建筑```
WSL Environment                    Windows Host
┌─────────────────┐               ┌──────────────────────┐
│                 │               │                      │
│  Claude/User    │               │  Script Watcher      │
│      ↓          │               │  (Scheduled Task)    │
│  wsl-submit.sh  │───────┐       │         ↓            │
│      ↓          │       │       │  FileSystemWatcher   │
│  Copy to queue  │       │       │         ↓            │
│                 │       │       │  Execute Script      │
└─────────────────┘       │       │         ↓            │
│       │  Capture Logs        │
Shared Folder          │       │         ↓            │
┌─────────────────────────┼───────┼──────────────────────┐
│ /mnt/d/Dev2/wsl-...     │       │  D:\Dev2\wsl-...     │
│                         │       │                      │
│  queue/ ←───────────────┘       │  ← Monitor           │
│  logs/                          │  → Write             │
│  completed/                     │  → Move (success)    │
│  archive/                       │  → Move (failure)    │
└─────────────────────────────────┴──────────────────────┘

目录结构```

wsl-windows-script-runner/
├── queue/ # Drop scripts here (monitored)
├── logs/ # Execution logs with timestamps
├── completed/ # Successfully executed scripts
├── archive/ # Failed scripts
├── ScriptWatcher.ps1 # Main file watcher service
├── Install-ScriptWatcher.ps1 # Installation script
├── Uninstall-ScriptWatcher.ps1 # Removal script
├── Get-WatcherStatus.ps1 # Status checker
├── wsl-submit.sh # WSL helper script
└── README.md # This file


## 安装

### 步骤1:安装计划任务(Windows,作为管理员)```powershell
# Open PowerShell as Administrator
cd D:\Dev2\wsl-windows-script-runner

# Install the service
.\Install-ScriptWatcher.ps1

这将:

  • 创建一个名为“WSL Windows ScriptRunner”的计划任务
  • 将其配置为在系统启动时运行
  • 以SYSTEM权限运行以获得最大兼容性
  • 设置故障时自动重启

步骤2:验证安装```powershell

Check status (Windows)

.\Get-WatcherStatus.ps1

Or from WSL

/mnt/d/Dev2/wsl-windows-script-runner/wsl-submit.sh --status


### 步骤3:可选-将WSL助手添加到PATH```bash
# Add to your ~/.bashrc or ~/.zshrc
echo 'alias wsl-run="/mnt/d/Dev2/wsl-windows-script-runner/wsl-submit.sh"' >> ~/.bashrc
source ~/.bashrc

# Now you can use:
wsl-run script.ps1
wsl-run --status
wsl-run --logs

用法

来自WSL

提交脚本以供执行```bash

Using the helper script

/mnt/d/Dev2/wsl-windows-script-runner/wsl-submit.sh myscript.ps1

Or if you added the alias

wsl-run myscript.ps1

Or copy directly

cp myscript.bat /mnt/d/Dev2/wsl-windows-script-runner/queue/


#### 检查状态```bash
wsl-run --status

查看日志```bash

List recent logs

wsl-run --logs

Filter logs

wsl-run --logs backup

Tail a specific log

wsl-run --tail backup_20250115_143022.log


#### 实时观察队列```bash
wsl-run --watch

从Windows

手动执行(测试)```powershell

Run the watcher manually (for testing)

.\ScriptWatcher.ps1

Press Ctrl+C to stop


#### 检查状态```powershell
.\Get-WatcherStatus.ps1

# Or check the scheduled task
Get-ScheduledTask -TaskName "WSL-Windows-ScriptRunner"

启动/停止服务```powershell

Start

Start-ScheduledTask -TaskName "WSL-Windows-ScriptRunner"

Stop

Stop-ScheduledTask -TaskName "WSL-Windows-ScriptRunner"

Restart

Stop-ScheduledTask -TaskName "WSL-Windows-ScriptRunner"
Start-ScheduledTask -TaskName "WSL-Windows-ScriptRunner"


## 例子

### 示例1:简单PowerShell脚本

**来自WSL:**```bash
# Create a test script
cat > /tmp/test.ps1 << 'EOF'
Write-Host "Hello from Windows!"
Write-Host "Current User: $env:USERNAME"
Write-Host "Computer: $env:COMPUTERNAME"
Get-Date
EOF

# Submit it
wsl-run /tmp/test.ps1

# View the log
wsl-run --logs test

日志输出: logs/test_20250115_143022.log

示例2:带有错误处理的批处理脚本

来自WSL:```bash
cat > /tmp/backup.bat << 'EOF'
@echo off
echo Starting backup...
echo Timestamp: %DATE% %TIME%

REM This will fail - demonstrates error logging
copy "C:\NonExistent\file.txt" "C:\Backup\" 2>&1

echo Backup process completed
EOF

wsl-run /tmp/backup.bat

Check the archive (failed scripts)

ls /mnt/d/Dev2/wsl-windows-script-runner/archive/


### 示例3:Claude代码集成

当Claude需要从WSL运行Windows命令时:```bash
# Claude creates a script
cat &gt; /tmp/windows-task.ps1 &lt;&lt; &#x27;EOF&#x27;
# Install a Windows application
winget install --id Microsoft.PowerToys --silent

# Check if installation succeeded
if ($LASTEXITCODE -eq 0) {
Write-Host &quot;Installation successful&quot;
} else {
Write-Error &quot;Installation failed with code: $LASTEXITCODE&quot;
exit $LASTEXITCODE
}
EOF

# Submit for execution
/mnt/d/Dev2/wsl-windows-script-runner/wsl-submit.sh /tmp/windows-task.ps1

# Wait and check the log
sleep 5
latest_log=$(ls -t /mnt/d/Dev2/wsl-windows-script-runner/logs/*.log | head -1)
cat &quot;$latest_log&quot;

日志格式

每次执行都会创建一个带时间戳的日志文件,其中包含:```

Script Execution Log

Script: D:\Dev2\wsl-windows-script-runner\queue\test.ps1
Started: 2025-01-15 14:30:22
Host: DESKTOP-ABC123
User: SYSTEM
Working Directory: D:\Dev2\wsl-windows-script-runner
========================================

--- Standard Output ---
Hello from Windows!
Current User: SYSTEM
Computer: DESKTOP-ABC123
Wednesday, January 15, 2025 2:30:22 PM

--- Standard Error ---

========================================
Execution Summary
========================================
Exit Code: 0
Completed: 2025-01-15 14:30:23
Duration: 00:00:01.1234567
Status: SUCCESS
========================================


## 故障排除

### 任务未运行```powershell
# Check task status
Get-ScheduledTask -TaskName &quot;WSL-Windows-ScriptRunner&quot; | Format-List *

# Check last run result
Get-ScheduledTaskInfo -TaskName &quot;WSL-Windows-ScriptRunner&quot;

# View task history in Event Viewer
# Event Viewer → Task Scheduler → Task Scheduler Library

脚本未执行

  1. 检查任务是否正在运行:```powershell
    Get-ScheduledTask -TaskName "WSL-Windows-ScriptRunner" | Select State

1. **手动运行监视器以查看错误:**```powershell
.\ScriptWatcher.ps1
  1. 检查文件权限:```bash
    ls -l /mnt/d/Dev2/wsl-windows-script-runner/queue/

### 脚本卡在队列中

- 文件可能仍被锁定(正在写入)
- 检查监视器是否正在运行: `Get-WatcherStatus.ps1`
- 检查文件扩展名是否为.ps1、.bat或.cmd
- 尝试重新启动计划任务

### 未创建日志

- 检查日志目录是否存在以及是否可写
- 跑 `Get-WatcherStatus.ps1` 验证路径
- 检查任务计划程序是否存在执行错误
- 验证SYSTEM帐户是否具有写入权限

## 高级配置

### 自定义路径```powershell
# Install with custom paths
.\Install-ScriptWatcher.ps1 -TaskName &quot;MyScriptRunner&quot;

# Run watcher with custom paths
.\ScriptWatcher.ps1 `
-QueuePath &quot;C:\CustomQueue&quot; `
-LogPath &quot;C:\CustomLogs&quot; `
-CompletedPath &quot;C:\CustomCompleted&quot; `
-ArchivePath &quot;C:\CustomArchive&quot;

文件稳定性延迟

如果脚本很大,需要时间编写:```powershell
.\ScriptWatcher.ps1 -FileStabilityDelayMs 5000 # Wait 5 seconds


### 执行策略

如果遇到执行策略错误:```powershell
# Check current policy
Get-ExecutionPolicy

# Set to allow local scripts (as Administrator)
Set-ExecutionPolicy -Scope LocalMachine -ExecutionPolicy RemoteSigned -Force

安全考虑

  • 作为系统运行:计划任务以SYSTEM权限运行,以实现最大兼容性
  • 无认证:将执行放置在队列文件夹中的任何文件
  • 代码执行:脚本具有完全的系统访问权限-仅在受信任的环境中使用
  • 网络接入:脚本可以访问网络资源
  • 文件权限:确保队列文件夹具有适合您的安全要求的ACL

推荐:仅在开发/测试环境中或在您信任所有用户都可以访问队列文件夹的系统上使用此工具。

卸载```powershell

Open PowerShell as Administrator

cd D:\Dev2\wsl-windows-script-runner

Remove the scheduled task

.\Uninstall-ScriptWatcher.ps1

Optionally, delete the entire directory

cd ..

Remove-Item -Recurse -Force wsl-windows-script-runner


## 与Claude Code集成

### 最佳选择:MCP服务器(推荐)⭐

安装MCP服务器以实现无缝集成:```bash
cd /mnt/d/Dev2/wsl-windows-script-runner/mcp-server
./setup.sh
./configure-claude.sh

然后简单地问克劳德:

  • “使用windows_enxecute检查windows磁盘空间”
  • “使用Windows_enxecute获取Windows版本”
  • “检查Windows脚本运行程序状态”

看 mcp服务器/README.md 了解详情。

替代方案:手动命令

添加到您的 ~/.claude/CLAUDE.md:

## WSL-Windows Script Runner

When you need to execute Windows-native commands from WSL:

1. Create a PowerShell or batch script with the required commands
2. Submit using: `/mnt/d/Dev2/wsl-windows-script-runner/wsl-submit.sh script.ps1`
3. Check logs in: `/mnt/d/Dev2/wsl-windows-script-runner/logs/`

Helper alias: `wsl-run

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Wsl Windows Script Runner 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Wsl Windows Script Runner 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Wsl Windows Script Runner 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Wsl Windows Script Runner 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Wsl Windows Script Runner 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Wsl Windows Script Runner 能提供哪些能力?

资料显示能力标签包括 PowerShell、日志记录、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。