{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3ppbtze3pw9u","handle":"iflow-mcp-mcp-terminal","url":"https://wellknown.network/agents/iflow-mcp-mcp-terminal","links":{"self":"https://wellknown.network/agents/iflow-mcp-mcp-terminal/record.json","html":"https://wellknown.network/agents/iflow-mcp-mcp-terminal","markdown":"https://wellknown.network/agents/iflow-mcp-mcp-terminal/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-terminal","status":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-terminal/status","claim":"https://wellknown.network/agents/iflow-mcp-mcp-terminal/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-mcp-terminal/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-mcp-terminal/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-terminal/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-terminal/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-mcp-terminal","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_mcp-terminal","summary":"MCP Terminal Server for controlling terminal operations","description":"<div align=\"center\">\n\n# MCP Terminal\n\nMCP Terminal 是一个基于 MCP（Model Context Protocol）的终端控制服务器，专为与大型语言模型（LLM）和 AI 助手集成而设计。它提供了一个标准化的接口，使 AI 可以执行终端命令并获取输出结果。\n\n<a href=\"https://glama.ai/mcp/servers/@sichang824/mcp-terminal\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@sichang824/mcp-terminal/badge\" alt=\"Terminal MCP server\" />\n</a>\n\n[English](README.en.md) | 中文\n\n</div>\n\n## 演示视频\n\n[![演示视频](./docs/image.jpg)](https://player.bilibili.com/player.html?isOutside=true&aid=114488023981820&bvid=BV1agEuzGE1X&cid=29904276803&p=1)\n\n## 特性\n\n- 使用官方 MCP SDK 实现\n- 支持多种终端控制器：\n  - **iTerm2 控制器**：在 macOS 上使用 iTerm2 的 Python API 提供高级控制\n  - **AppleScript 控制器**：在 macOS 上使用 AppleScript 控制 Terminal 应用\n  - **Subprocess 控制器**：在所有平台上通用的终端控制方式\n- 支持多种服务器模式：\n  - **STDIO 模式**：通过标准输入/输出与客户端通信\n  - **SSE 模式**：通过 Server-Sent Events 提供 HTTP API\n- 提供多种工具：\n  - **终端工具**：执行命令并获取输出\n  - **文件工具**：进行文件操作（读写、追加、插入）\n- 自动检测最佳终端控制器\n- 与 Claude Desktop 无缝集成\n- 支持 Docker 部署\n\n## 安装\n\n### 先决条件\n\n- Python 3.8+\n- [uv](https://github.com/astral-sh/uv) 包管理工具\n\n如果您还没有安装 uv，可以通过以下命令安装：\n\n```bash\n# 在macOS上使用Homebrew\nbrew install uv\n\n# 在其他平台上\npip install uv\n```\n\n### 使用 uv 安装（推荐）\n\n克隆仓库并使用 uv 安装依赖：\n\n```bash\n# 克隆仓库\ngit clone https://github.com/yourusername/mcp-terminal.git\ncd mcp-terminal\n\n# 创建虚拟环境并安装基本依赖\nuv venv\nsource .venv/bin/activate  # 在Windows上使用 .venv\\Scripts\\activate\nuv pip install -e .\n\n# 如果需要iTerm2支持 (仅限macOS)\nuv pip install -e \".[iterm]\"\n\n# 如果需要开发工具（测试、代码格式化等）\nuv pip install -e \".[dev]\"\n```\n\n> **注意：如需使用 iTerm2 控制器，必须在 iTerm2 设置中启用 Python API。**\n>\n> 打开 iTerm2，依次进入 `Preferences` → `General` → `Magic`，勾选 **Enable Python API** 选项，如下图所示：\n>\n> ![Enable Python API in iTerm2](./docs/iterm2-enable-python-api.png)\n\n### 使用 Makefile 安装\n\n我们提供了 Makefile 来简化常见操作：\n\n```bash\n# 安装基本依赖\nmake setup\n\n# 安装iTerm2支持\nmake setup-iterm\n\n# 安装开发依赖\nmake setup-dev\n```\n\n### 使用 Docker 安装\n\n我们提供了 Docker 支持，可以快速部署 MCP Terminal 服务器：\n\n```bash\n# 构建 Docker 镜像\ndocker build -t mcp-terminal .\n\n# 运行 Docker 容器（SSE模式，端口8000）\ndocker run -p 8000:8000 mcp-…","publisher":{"name":"MCP Terminal Developer","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_mcp-terminal","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_mcp-terminal","registry":"pypi","observedAt":"2026-09-15T19:23:14.671Z","publishedAt":"2025-10-28T03:46:34.507762Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_mcp-terminal","url":"https://pypi.org/project/iflow-mcp_mcp-terminal/","firstSeenAt":"2026-09-09T20:23:59.323Z","fetchedAt":"2026-09-15T19:21:34.634Z","normalizedAt":"2026-09-15T19:21:34.634Z"}]},"firstSeenAt":"2026-09-09T20:23:59.323Z","updatedAt":"2026-09-15T19:23:14.671Z"}