MCP终端服务器

MCP终端服务器通过一个简洁的网页界面提供终端访问和系统工具。它可以通过简单的HTTP服务器实现远程命令执行、目录列表以及其他终端操作。

功能

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

安装前提条件

在安装MCP终端服务器之前，请确保您的系统满足以下要求：

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

快速安装

使用一条命令安装MCP终端服务器：

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终端服务器：

启动服务器

mcp-terminal start

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

mcp-terminal start --port 9000

停止服务器

mcp-terminal stop

检查服务器状态

mcp-terminal status

这会显示：

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

重启服务器

mcp-terminal restart

卸载

要完全移除MCP终端服务器：

mcp-terminal uninstall

网页界面

一旦服务器运行，可以在以下地址访问网页界面：

http://localhost:8080

（或您指定的自定义端口）

网页界面提供：

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

配置

MCP终端服务器存储其文件在：

• ~/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. 确保~/bin在您的PATH中：

   echo $PATH
   

2. 如果不在，请手动添加：

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

3. 对于永久添加，请添加到您的shell配置中：

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

安全注意事项

• MCP终端服务器以启动它的用户相同的权限执行命令
• 建议在局域网内或防火墙后面运行服务器
• 考虑使用带有身份验证的反向代理进行公共部署

许可证

MIT许可证

贡献

欢迎贡献！请随时提交Pull Request。

支持

对于问题、疑问或反馈，请在GitHub仓库中打开一个issue。