iTerm-MCP 安装与配置指南

1. 项目基础介绍

iTerm-MCP 是一个开源项目，它提供了一个 Model Context Protocol (MCP) 服务器，该服务器能够在当前 iTerm 终端会话中执行命令。这个工具对于需要与命令行界面（CLI）交互的 REPL 环境和自动化脚本特别有用。

主要编程语言：TypeScript 和 JavaScript。

2. 关键技术和框架

• Model Context Protocol (MCP): 一种允许模型与终端会话交互的协议。
• Node.js: 项目的运行环境，负责处理终端的输入和输出。
• iTerm2: 一个功能丰富的终端应用程序，用于 macOS，本项目通过与 iTerm2 交互来执行命令。

3. 安装和配置

准备工作

在开始安装之前，请确保您的系统中已满足以下要求：

• iTerm2 必须已在您的系统上安装并运行。
• Node.js 版本需为 18 或更高。

安装步骤

1. 安装 Node.js

   如果您的系统还未安装 Node.js，请访问 Node.js 官方网站下载并安装。

2. 克隆项目仓库

   打开终端，使用以下命令克隆 iTerm-MCP 项目：

   git clone https://github.com/ferrislucas/iterm-mcp.git
   

   或者如果您希望直接使用 npm 安装：

   npm install -g iterm-mcp
   

3. 配置 Claude Desktop (可选)

   如果您希望与 Claude Desktop 配合使用 iTerm-MCP，需要添加服务器配置。

   • 在 macOS 上:

     打开文件 ~/Library/Application Support/Claude/claude_desktop_config.json 并添加以下内容：

     {
       "mcpServers": {
         "iterm-mcp": {
           "command": "npx",
           "args": ["-y", "iterm-mcp"]
         }
       }
     }
     

   • 在 Windows 上:

     打开文件 %APPDATA%/Claude/claude_desktop_config.json 并添加上述相同内容。

4. 使用 Smithery 自动安装 (可选)

   若要使用 Smithery 自动安装 iTerm-MCP，请在终端运行以下命令：

   npx -y @smithery/cli install iterm-mcp --client claude
   

5. 构建项目

   进入项目目录，执行以下命令构建项目：

   cd iterm-mcp
   yarn install
   yarn run build
   

6. 运行项目

   构建完成后，可以通过以下命令启动 MCP 服务器：

   yarn start
   

请注意，使用 iTerm-MCP 时，用户需负责确保安全使用，因为该工具不会对执行的命令进行安全性评估。在使用过程中，用户应密切监控活动，并在必要时中断模型的执行。