MCP 终端工具

一个跨平台的模型上下文协议 (MCP) 服务器，用于终端访问和系统工具。此软件包允许像 Claude 这样的 AI 助手与您的本地系统进行交互。

功能

• 运行 shell 命令
• 执行 Python 脚本
• 列出目录内容
• 复制文件
• 创建文件和目录
• 跨平台支持 (Windows, macOS, Linux)
• 适用于 Claude Desktop 和其他 MCP 兼容的助手

安装

全局安装 (推荐)

# 通过 npm 全局安装
npm install -g github:Yaswanth-ampolu/smithery-mcp-server

# 启动服务器
mcp-terminal

本地安装

# 克隆仓库
git clone https://github.com/Yaswanth-ampolu/smithery-mcp-server.git
cd smithery-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

配置 Claude Desktop

1. 打开 Claude Desktop
2. 进入 Settings → Model Context Protocol
3. 添加以下配置：

{
  "mcpServers": {
    "terminal": {
      "url": "http://localhost:8080/sse",
      "command": "terminal"
    }
  }
}

4. 保存并重启 Claude Desktop
5. 通过询问 Claude 进行测试: "terminal ls" 或 "terminal echo hello"

环境变量

创建一个 .env 文件来自定义设置：

# 服务器设置
SERVER_NAME=MCP System Tools
SERVER_VERSION=1.0.0
PORT=8080

# Python 解释器路径 (如果未设置，将默认为平台适当的值)
PYTHON_PATH=

# 默认工作区目录 (如果未指定，将自动确定)
# DEFAULT_WORKSPACE=C:\path\to\workspace  # Windows
# DEFAULT_WORKSPACE=/path/to/workspace    # Mac/Linux

# 服务器绑定
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=8080

可用工具

工具	描述
runShellCommand	运行一个 shell 命令并返回其输出
runPythonFile	执行一个 Python 脚本并返回其输出
readDirectory	列出目录中的文件和文件夹
copyFile	将文件从一个位置复制到另一个位置
createFile	创建一个具有指定内容的新文件

工作区目录

服务器使用工作区目录进行文件操作：

1. 如果在 .env 中设置了 DEFAULT_WORKSPACE，则使用该位置
2. 否则，它会在当前目录中查找 workspace 文件夹
3. 如果未找到，它会在您的桌面上创建一个 mcp-workspace 文件夹
4. 如果桌面不可用，它会在您的主目录中创建它

许可证

MIT