MCP 终端服务器
轻量级的 FastAPI 服务器，可以作为 Windows 服务运行，并公开一个端点来执行 shell 命令并流式传输其输出。
特征
作为 Windows 服务或以调试模式运行
执行 shell 命令并实时传输其输出
API密钥认证
速率限制
可通过环境变量或配置文件进行配置
强大的错误处理和日志记录
失败时自动重新启动进程
Related MCP server: Shell MCP Server
安装
先决条件
Windows操作系统
Python 3.7 或更高版本
管理员权限（用于服务安装）
安装步骤
克隆此存储库或下载源代码
以管理员身份打开 PowerShell
导航到项目目录
运行安装脚本：
这将：
安装所需的 Python 依赖项
生成随机 API 密钥（或使用您提供的密钥）
创建配置文件
安装并启动 Windows 服务
安装选项
您可以使用以下参数自定义安装：
可用参数：
-ApiKey：用于身份验证的自定义 API 密钥-Port：服务器的端口号（默认值：8000）-Host：绑定到的主机地址（默认值：0.0.0.0）-LogLevel：日志级别（调试、信息、警告、错误、严重）-ConfigFile：自定义配置文件的路径
配置
可以通过以下方式配置服务器：
环境变量
配置文件（config.json）
安装期间的命令行参数
配置文件
提供了一个示例配置文件（ config.json.sample ）。您可以将其复制到config.json并进行修改：
环境变量
您还可以使用环境变量配置服务器：
MCP_TERMINAL_API_KEY：用于身份验证的 API 密钥MCP_HOST：绑定到的主机地址MCP_PORT：服务器的端口号MCP_LOG_LEVEL：日志级别MCP_LOG_FILE：日志文件路径MCP_MAX_LOG_SIZE_MB：最大日志文件大小（以 MB 为单位）MCP_LOG_BACKUP_COUNT：要保留的日志备份文件的数量MCP_RESTART_ON_FAILURE：失败时是否重新启动服务器MCP_MAX_RESTART_ATTEMPTS：重启尝试的最大次数MCP_RESTART_DELAY_SECONDS：重启尝试之间的延迟MCP_SHUTDOWN_TIMEOUT_SECONDS：正常关机超时MCP_WORKING_DIRECTORY：服务器的工作目录
服务管理
服务命令
可以使用以下命令管理该服务：
日志
日志存储在配置的日志文件中（默认值： mcp_terminal_server.log ）。日志包括：
服务启动/停止事件
命令执行
错误和警告
健康检查结果
API 使用
测试客户端
提供了一个强大的测试客户端来与服务器交互，具有以下功能：
命令行参数以提高可用性
API密钥认证支持
彩色输出，更易读
支持将输出保存到文件
强大的错误处理和日志记录
具有命令历史记录的交互模式
服务器健康检查功能
基本用法
配置文件
可以使用 JSON 配置文件来配置测试客户端。根据提供的示例创建一个client_config.json文件：
然后使用它：
环境变量
测试客户端还支持通过环境变量进行配置：
MCP_TERMINAL_API_KEY：用于身份验证的 API 密钥MCP_TERMINAL_SERVER_URL：服务器 URL
API 端点
POST /run：执行命令需要
X-API-Key标头中的 API 密钥请求正文：
{"command": "your command"}返回带有命令输出的流式响应
GET /health：检查服务器健康状况返回
{"status": "healthy", "active_sessions": 0}
安全注意事项
在生产环境中始终更改默认 API 密钥
如果服务器只能在本地访问，则将主机限制为
127.0.0.1考虑在生产中使用 HTTPS
服务器阻止潜在的危险命令，但可能需要额外的安全措施
故障排除
检查日志文件中是否存在错误
在调试模式下运行以查看控制台输出：
python service.py debug验证服务是否正在运行：
Get-Service -Name "MCP_Terminal_Server"检查 Windows 事件查看器中是否存在与服务相关的错误
执照
麻省理工学院