赢得任务人mcp
    
一个轻量级的MCP(模型上下文协议)服务器,为AI代理提供Windows进程和端口管理工具。不再脆弱 tasklist | findstr 或 netstat -ano 管道——只是可靠工作的结构化跨shell工具。
为什么?
人工智能代理在开发过程中经常需要管理进程——杀死卡住的开发服务器,找出阻塞端口的原因,或列出正在运行的服务。通过Windows上的Bash执行此操作是脆弱的: tasklist 输出解析中断, netstat 需要管道穿过 findstr,PowerShell命令存在引用问题。此MCP服务器提供干净、结构化的工具,无论shell如何,这些工具都能正常工作。
需求
- Windows 10或更高版本 (使用Windows 10以来可用的Win32 API)
- Go 1.22+(仅从源代码构建)
快速开始
下载二进制文件
预构建的二进制文件可在 发布 页面。
从源代码构建
git clone https://github.com/lexandro/win-taskman-mcp.git
cd win-taskman-mcp
go build -trimpath -ldflags="-s -w" -o win-taskman-mcp.exe .在克劳德代码中注册
这 register 子命令会自动将服务器添加到Claude Code的配置中,无需手动编辑JSON。
# Register for a project (creates .mcp.json in the project root)
./win-taskman-mcp.exe register project /path/to/your/project
# Or register globally for all projects (updates ~/.claude.json)
./win-taskman-mcp.exe register user就是这样——Claude Code将自动发现并使用流程管理工具。
手动配置
您也可以直接编辑配置文件:
{
"mcpServers": {
"win-taskman-mcp": {
"command": "C:\\path\\to\\win-taskman-mcp.exe"
}
}
}MCP工具
list_processes
列出正在运行的Windows进程。可选择按名称过滤。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
filter | string | no | 进程名称上不区分大小写的子字符串匹配 |
{ "filter": "node" }答复:
pid:1234 name:node.exe ppid:5678
pid:2345 name:node.exe ppid:5678结果以100个条目为限。使用 filter 缩小范围。
kill_process
通过PID终止Windows进程。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
pid | number | yes | 要终止的进程ID |
{ "pid": 1234 }答复:
Killed process 1234find_process_by_port
查找哪个进程正在使用特定的TCP端口。返回PID、进程名称、协议和连接状态。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
port | number | yes | 要查找的TCP端口号 |
{ "port": 3000 }答复:
pid:1234 name:node.exe port:3000 proto:TCP state:LISTEN local:0.0.0.0 remote:0.0.0.0:0kill_process_by_port
使用特定的TCP端口终止进程。单步:找到进程并终止它。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
port | number | yes | TCP端口号--使用此端口终止进程 |
{ "port": 3000 }答复:
Killed pid:1234 name:node.exe (was on port 3000)代币效率
所有输出都旨在最大限度地减少上下文窗口的使用:
- 紧凑键:值格式 —
pid:1234 name:node.exe而不是冗长的表格 - 无装饰铬 --无方框图、横幅或冗余标题
- 有限的结果 --最多100个进程,报告截断
- 文本错误 —
Error: access denied不是堆栈跟踪
建筑
main.go--入口点,CLI子命令调度server/--MCP服务器设置、工具注册(stdio传输)tools/--MCP工具处理程序(进程列表/终止、端口查找)taskman/-Windows任务管理核心(Win32 API调用通过golang.org/x/sys/windows)register/—registerClaude Code配置自动注册的子命令
沟通
- 仅限标准MCP传输(无HTTP,无开放端口)
- 记录到stderr,从不记录到stdout
- 所有输出AI优化:紧凑按键:值格式,无装饰铬
发展
# Build
go build -trimpath -ldflags="-s -w" -o win-taskman-mcp.exe .
# Test
go test ./...
# Vet
go vet ./...许可证
麻省理工学院
