FastMCP App Closer

MCP 服务器，用于关闭正在运行的应用程序。

功能特性

• 🔍 智能进程查找 - 支持模糊匹配进程名
• 🎯 别名支持 - 内置常见应用别名（微信、飞书、钉钉等）
• 🛡️ 安全保护 - 防止关闭系统关键进程
• 🌍 跨平台 - 支持 Windows、macOS、Linux

Installation

From PyPI (Recommended)

pip install fastmcp-app-closer

From Source

git clone https://github.com/yourusername/fastmcp-app-closer.git
cd fastmcp_app_closer
pip install -e .

使用方法

启动 MCP 服务器

fastmcp-app-closer

可用工具

1. close_app - 关闭应用

关闭指定名称的应用程序。

参数：

• appName (string, required) - 应用名称或进程名

示例：

{
  "tool": "close_app",
  "arguments": {
    "appName": "微信"
  }
}

支持的匹配方式：

• 精确匹配：WeChat.exe
• 模糊匹配：wechat、WeChat
• 别名匹配：微信、weixin

2. list_running_apps - 列出运行的应用

列出所有正在运行的应用程序。

示例：

{
  "tool": "list_running_apps"
}

支持的应用别名

更多别名请查看 ALIAS_GUIDE.md

故障排除

应用无法识别？

如果遇到 "No matching process found" 错误：

1. 查看实际进程名

   # Windows
   Get-Process | Select-Object Name
   
   # macOS/Linux
   ps aux | grep -i "app_name"
   

2. 添加自定义别名

   编辑 src/app_closer_mcp/aliases.py，在 PROCESS_ALIASES 中添加：

   "应用中文名": {"actual_process_name"},
   

3. 使用实际进程名

   直接使用进程名而不是应用名：

   {"appName": "qqmusic"}  // 而不是 "QQ音乐"
   

详细指南请参考 ALIAS_GUIDE.md

安全限制

以下系统关键进程无法被关闭：

• Windows: explorer.exe, winlogon.exe, csrss.exe, services.exe, svchost.exe
• macOS: Finder, WindowServer, loginwindow
• Linux: systemd, init, Xorg

开发

运行测试

pip install -e ".[dev]"
pytest

代码格式化

black src/
ruff check src/

许可证

MIT License