MCP Terminal Server

MCP Terminal Server

MCP Terminal Server 通过简洁的 Web 界面提供终端访问和系统工具。它通过简单的 HTTP 服务支持远程命令执行、目录列表和其他终端操作。

功能

• 🚀 远程终端访问：从 Web 浏览器执行 shell 命令
• 📁 目录列表：浏览并列出任何目录中的文件
• 🔒 安全的本地安装：运行时无需 root 权限
• 🌐 Web 界面：简洁、现代的 UI，便于交互
• 🔄 实时更新：实时查看命令输出
• 🛠️ 轻松管理：使用简单命令启动、停止和管理服务

先决条件

安装 MCP Terminal Server 前，请确保系统满足以下要求：

• Node.js（版本 14 或更高）
• curl（用于下载安装脚本）
• tar（用于解压软件包）

快速安装

使用一条命令安装 MCP Terminal Server：

curl -o- https://github.com/Yaswanth-ampolu/smithery-mcp-server/raw/main/main/install-mcp.sh | bash

此操作将：

1. 下载安装脚本
2. 检查依赖项
3. 下载并解压服务文件
4. 设置必要的目录
5. 将命令添加到 PATH

手动安装

如果你希望在运行脚本前先检查它：

1. 下载安装脚本：

   curl -o install-mcp.sh https://github.com/Yaswanth-ampolu/smithery-mcp-server/raw/main/main/install-mcp.sh
   

2. 检查脚本内容：

   less install-mcp.sh
   

3. 运行安装程序：

   bash install-mcp.sh
   

用法

安装后，可使用以下命令管理 MCP Terminal Server：

启动服务

mcp-terminal start

默认情况下，服务会在端口 8080 上启动。要使用其他端口：

mcp-terminal start --port 9000

停止服务

mcp-terminal stop

检查服务状态

mcp-terminal status

此操作会显示：

• 服务是否正在运行
• 正在运行的服务的 PID
• 内存使用情况
• 访问 Web 界面的 URL

重启服务

mcp-terminal restart

卸载

要彻底移除 MCP Terminal Server：

mcp-terminal uninstall

Web 界面

服务运行后，可通过以下地址访问 Web 界面：

http://localhost:8080

（或使用你指定的自定义端口）

Web 界面提供：

• 命令执行工具
• 目录列表工具
• 实时输出显示

配置

MCP Terminal Server 将文件存储在以下位置：

• ~/mcp-terminal - 主安装目录
• ~/bin/mcp-terminal - 命令脚本

日志文件和 PID 信息存储在以下位置：

• ~/mcp-terminal/mcp.log - 服务日志文件
• ~/mcp-terminal/mcp.pid - 服务 PID 文件

故障排除

服务无法启动

如果服务启动失败：

1. 检查是否已安装 Node.js，且版本为 14 或更高：

   node -v
   

2. 检查日志文件中的错误：

   tail -n 50 ~/mcp-terminal/mcp.log
   

3. 确认安装目录存在：

   ls -la ~/mcp-terminal
   

端口已被占用

如果默认端口（8080）已被占用：

mcp-terminal start --port 9000

找不到命令

如果找不到 mcp-terminal 命令：

1. 确保 PATH 中包含 ~/bin：

   echo $PATH
   

2. 如果没有，请手动添加：

   export PATH="$HOME/bin:$PATH"
   

3. 如需永久添加，请将其加入 shell 配置：

   echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
   source ~/.bashrc
   

安全注意事项

• MCP Terminal Server 执行命令时使用启动它的用户所拥有的权限
• 建议在本地网络上或防火墙后运行服务
• 对于面向公众的部署，请考虑使用带身份验证的反向代理

许可证

MIT 许可证

贡献

欢迎贡献！欢迎提交 Pull Request。

支持

如有问题、疑问或反馈，请在 GitHub 仓库 中提交 issue。