smithery-mcp-server

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