MCP Terminal Server

基本能力

产品定位

MCP Terminal Server 是一个轻量级的 FastAPI 服务器，主要用于在 Windows 环境下执行 shell 命令并实时流式传输其输出。

核心功能

• 可以作为 Windows 服务运行或在调试模式下运行
• 执行 shell 命令并实时流式传输其输出
• API 密钥认证
• 速率限制
• 通过环境变量或配置文件进行配置
• 强大的错误处理和日志记录
• 失败时自动重启进程

适用场景

• 远程执行 shell 命令
• 自动化脚本执行
• 服务器管理和监控

工具列表

• install_service.ps1: 安装脚本，用于安装和配置服务
• service.py: 服务管理脚本，用于安装、启动、停止、重启、移除和更新服务
• test_client.py: 测试客户端，用于与服务器交互

常见问题解答

• 如何检查服务是否运行？使用 Get-Service -Name "MCP_Terminal_Server"
• 如何查看日志？检查配置的日志文件（默认：mcp_terminal_server.log）
• 如何调试？运行 python service.py debug 以查看控制台输出

使用教程

使用依赖

• Windows 操作系统
• Python 3.7 或更高版本
• 管理员权限（用于服务安装）

安装教程

1. 克隆此存储库或下载源代码
2. 以管理员身份打开 PowerShell
3. 导航到项目目录
4. 运行安装脚本：

.\install_service.ps1

安装选项

.\install_service.ps1 -ApiKey "your-api-key" -Port 8080 -Host "127.0.0.1" -LogLevel "debug"

调试方式

# 运行调试模式
python service.py debug

# 检查服务状态
Get-Service -Name "MCP_Terminal_Server"

# 查看日志
cat mcp_terminal_server.log

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。