赢得任务人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 ./...许可证
麻省理工学院