Termcp

io.github.open-mcp-ai由 GitHub 帳號 open-mcp-ai 發布v0.2.8更新於 Oct 27, 2026

An MCP server that lets AI agents act like a human at a real terminal, local or over SSH.

已驗證STDIO僅桌面雲端與基礎設施開發者工具

概覽

AI 產生的概覽

讓 AI 代理像人一樣操作真實終端的 MCP 伺服器，支援本機或 SSH 遠端，僅暴露一個工具。

可以做什麼
  • 在本機或 SSH 遠端的真實終端中執行指令
  • 在執行階段安裝、撰寫並熱載入其他 MCP 伺服器與技能
  • 管理主機，並透過 SSH 跨機器呼叫 MCP 伺服器
  • 透過網頁介面與人類共用同一批終端進行協作
適用情境
適合需要讓助理直接操作 shell 而非呼叫單一 API 的情境：安裝或串接其他 MCP 伺服器、透過 SSH 在遠端主機上執行指令，或與人類在共用終端工作階段中協同作業。
執行需求
以本機程序執行，通常透過 npx 加 daemon stdio 子指令啟動，也可用 Go 安裝、Docker 映像或預先編譯的執行檔。已有實例在執行時可用 HTTP 傳輸。Docker 部署需設定 TERMCP_AUTH_TOKEN；使用 --auth-token 時用戶端需送出 bearer Authorization 標頭。
安裝前請注意
助理取得 shell 權限，可執行任意指令、修改或刪除資料，並透過 SSH 操作遠端主機。它還能安裝並熱載入其他 MCP 伺服器，進一步擴大可執行的範圍。Docker 範例要求設定 TERMCP_AUTH_TOKEN，請使用足夠長的隨機密鑰，並避免把 HTTP 端點暴露在不受信任的網路。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Termcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[header banner]

[Termcp logo]

⚡ Termcp

[Termcp tagline]

[Stars] [Forks] [Release]

[Platform] [Pure Go, No CGO] [MIT License]

English | 中文

[Install] [Docs] [Website]

[divider]

Termcp: the final MCP | Terminus MCP

With Termcp:

  • An AI can install and use any number of MCP servers, dynamically, at run time.
  • An AI can write its own MCP server and hot-load it.
  • An AI can use SSH to manage hosts, approved and collaborated on by a human.
  • An AI can install and call MCP servers across machines over nothing but SSH.

Exactly one tool is exposed. Built on the Termcp protocol (Terminalization Model Context Protocol): loading more MCP servers and skills does not grow the context.

A single dependency-free binary (10 MB+), cross-platform, with a WYSIWYG web UI where a human and an AI share the same terminals and collaborate.

[Termcp extensions panel: which MCPs are installed, which host each one runs on, and whether it is available]

Install 80+ MCP servers and skills.

[Termcp console: local and SSH sessions on one screen, every line marked human / AI / shell output]

Host management.

Install

0 · AI install

Install npx -y @open-mcp-ai/termcp daemon stdio as an MCP named termcp.

Copy this to the AI.

1 · One command per agent

AgentCommand
Claude Codeclaude mcp add termcp -- npx -y @open-mcp-ai/termcp daemon stdio
Codexcodex mcp add termcp -- npx -y @open-mcp-ai/termcp daemon stdio
Gemini CLIgemini mcp add termcp npx -- -y @open-mcp-ai/termcp daemon stdio

2 · Config file

json
{  "mcpServers": {    "termcp": {      "command": "npx",      "args": ["-y", "@open-mcp-ai/termcp", "daemon", "stdio"]    }  }}
Other install methods — npm / Go / Docker / prebuilt binary
Command
npmnpm i -g @open-mcp-ai/termcp — installs a termcp command; with it, drop npx -y @open-mcp-ai/termcp from every snippet above and use termcp. Wrapper: open-mcp-ai/Termcp-npm.
Gogo install github.com/open-mcp-ai/termcp@latest — GOPROXY=https://goproxy.cn,direct in mainland China; also usable as a module (go get github.com/open-mcp-ai/termcp).
Dockerdocker run -d --name termcp -p 18765:18765 -v termcp-data:/home/termcp -e TERMCP_AUTH_TOKEN=change-me-to-a-long-random-secret ghcr.io/open-mcp-ai/termcp:latest termcp --no-internal --host 0.0.0.0 --port 18765
BinaryPrebuilt releases — linux / darwin / windows on amd64 / arm64, one static file each.

The npm wrapper downloads the matching prebuilt binary (override with TERMCP_VERSION, TERMCP_MIRROR, TERMCP_BIN, TERMCP_SKIP_DOWNLOAD). Flags: docs/cli.md. Docker recipes, Compose and a token-free loopback setup: docs/deploy.md.

HTTP transport, when an instance is already answering somewhere (npx -y @open-mcp-ai/termcp):

json
{  "mcpServers": {    "termcp": {      "type": "http",      "url": "http://localhost:18765/stream"    }  }}

Reachable from a client in Docker as http://host.docker.internal:18765/stream (macOS/Windows) or the host's LAN IP; from another container on the same network as http://termcp:18765/stream. Legacy SSE uses http://localhost:18765/sse — only /sse, JSON-RPC goes to /message by itself. With --auth-token, add a bearer header: "headers": {"Authorization": "Bearer <token>"}.

Docs

docs/cli.mdEvery flag and subcommand, capability gates, authentication.
docs/clients.mdAll four entrances end to end: MCP transports, the stdio bridge, authentication, REST examples, and the one-tool surface.
docs/deploy.mdDocker, multi-stage builds, Compose, pure-API build.
docs/protocol.mdTERM/1 specification: wire format, status codes, headers, the 19 directives, the three gates.
docs/capabilities.mdThe full capability surface and the security model.
docs/api.mdREST endpoints, WebSocket frames, locator resolution.
docs/capabilities.mdFull capability surface and the security model.
docs/architecture.mdSession kernel, entrances, storage.
docs/design/Design records: Web UI, resource model, session storage, font stack, mobile terminal.
CHANGELOG.mdRelease notes.

Benchmark

Comming Soon

Functional security testing

Comming Soon

Star History

[Star History Chart]

License

Released under the MIT License. Thanks to friends in the linux.do community for the discussions, feedback, and support.

[footer]

來源：README.md，提交 0595cb5

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次，以列出其工具，但未能完成：該軟體包類型無法在沙箱中執行。

版本歷史

9
  1. v0.2.8最新Oct 26, 2026
  2. v0.2.7Oct 9, 2026
  3. v0.2.6Oct 7, 2026
  4. v0.2.5Oct 1, 2026
  5. v0.2.4Sep 29, 2026
  6. v0.2.3Sep 26, 2026
  7. v0.2.2Sep 25, 2026
  8. v0.2.1Sep 20, 2026
  9. v0.1.17Sep 19, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分