使用说明
MCP终端服务器
MCP终端服务器通过干净的web界面提供终端访问和系统工具。它通过一个简单的HTTP服务器支持远程命令执行、目录列表和其他终端操作。
特性
- 🚀 远程终端访问：从web浏览器执行shell命令
- 📁 目录列表：浏览并列出任何目录中的文件
- 🔒 安全本地安装：运行时不需要root访问权限
- 🌐 web界面：简洁、现代的用户界面，便于交互
- 🔄 实时更新：查看命令输出
- 🛠️ 易于管理：启动、停止和管理服务器的简单命令
先决条件
在安装MCP终端服务器之前，请确保您的系统满足以下要求：
- Node.js （版本14或更高）
- 卷曲 （用于下载安装脚本）
- 磁带归档 （用于取出包裹）
快速安装
使用单个命令安装MCP终端服务器：
curl -o- https://github.com/Yaswanth-ampolu/smithery-mcp-server/raw/main/main/install-mcp.sh | bash
这将：
- 下载安装脚本
- 检查依赖关系
- 下载并解压缩服务器文件
- 设置必要的目录
- 将命令添加到PATH中
手动安装
如果您希望在运行脚本之前检查它：
-
下载安装脚本：
curl -o install-mcp.sh https://github.com/Yaswanth-ampolu/smithery-mcp-server/raw/main/main/install-mcp.sh -
查看脚本内容：
less install-mcp.sh -
运行安装程序：
bash install-mcp.sh
用法
安装后，可以使用以下命令管理MCP终端服务器：
启动服务器
mcp-terminal start
默认情况下，服务器在端口8080上启动。要使用其他端口，请执行以下操作：
mcp-terminal start --port 9000
停止服务器
mcp-terminal stop
正在检查服务器状态
mcp-terminal status
这表明：
- 服务器是否正在运行
- 正在运行的服务器的PID
- 内存使用
- 访问web界面的URL
重新启动服务器
mcp-terminal restart
卸载
要完全卸下MCP终端服务器：
mcp-terminal uninstall
web界面
服务器运行后，访问以下web界面：
http://localhost:8080
（或您指定的自定义端口）
web界面提供：
- 命令执行工具
- 目录列表工具
- 实时输出显示
配置
MCP终端服务器将其文件存储在：
~/mcp-terminal-主安装目录~/bin/mcp-terminal-命令脚本
日志文件和PID信息存储在：
~/mcp-terminal/mcp.log-服务器日志文件~/mcp-terminal/mcp.pid-服务器PID文件
故障排除
服务器无法启动
如果服务器无法启动：
-
检查是否安装了Node.js和14+版本：
node -v -
检查日志文件是否有错误：
tail -n 50 ~/mcp-terminal/mcp.log -
验证安装目录是否存在：
ls -la ~/mcp-terminal
端口已在使用中
如果默认端口（8080）已在使用中：
mcp-terminal start --port 9000
缺少命令
如果 mcp-terminal 找不到命令：
-
确保
~/bin在您的路径中：echo $PATH -
如果没有，请手动添加：
export PATH="$HOME/bin:$PATH" -
要永久添加，请添加到您的shell配置中：
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc source ~/.bashrc
安全考虑
- MCP终端服务器执行的命令权限与启动它的用户相同
- 建议在本地网络或防火墙后运行服务器
- 考虑在面向公众的部署中使用带有身份验证的反向代理
许可证
贡献
欢迎投稿！请随时提交拉取请求。
支持
有关问题、疑问或反馈，请在 GitHub存储库.
