termcp

Name: termcp
Author: open-mcp-ai

本地服务

github.com/open-mcp-ai开发工具602 天前更新

代码仓库

关于 termcp

termcp 为 AI Agent 提供终端接口，支持本地操作和通过 SSH 管理主机。它可动态加载 MCP 服务和技能，同时始终只暴露一个 MCP 工具。

主要功能

01在本地和通过 SSH 操作终端
02动态安装并调用 MCP 服务
03编写并热加载 MCP 服务
04无论加载多少服务都只暴露一个 MCP 工具
05通过共享 Web 终端界面协作

适用场景

01使用经人工批准的 SSH 访问管理远程主机
02在 Agent 会话中安装 MCP 服务
03运行时创建并加载自定义 MCP 服务
04与 Agent 在同一终端中协作

MCP 相关

termcp 是一个通过单个工具提供终端能力的 MCP 服务。它可动态安装和调用其他 MCP 服务，也支持通过 SSH 跨机器操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "open-mcp-ai-termcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/open-mcp-ai/termcp:0.2.8"
      ]
    }
  }
}

启动命令docker run -i --rm ghcr.io/open-mcp-ai/termcp:0.2.8

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocighcr.io/open-mcp-ai/termcp:0.2.8Streamable HTTP

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

页眉横幅

⚡ Termcp

英文 | 中文

分隔线

Termcp：终极 MCP | Terminus MCP

使用 Termcp：

AI 可以动态地在运行时安装和使用任意数量的 MCP 服务。
AI 可以编写自己的 MCP 服务并热加载。
AI 可以通过 SSH 管理经人工批准并协作维护的主机。
AI 只需通过 SSH，就能在多台机器上安装和调用 MCP 服务。

只会暴露一个工具。 基于 Termcp 协议（Terminalization Model Context Protocol）构建：加载更多 MCP 服务和技能不会增加上下文。

单个无依赖的二进制文件（10 MB 以上），支持跨平台运行，并提供所见即所得的 Web UI，让人类和 AI 共用相同的终端并进行协作。

安装 80 多个 MCP 服务和技能。

主机管理。

安装

0 · AI 安装

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

将此内容复制给 AI。

1 · 每个 Agent 一条命令

Agent	命令
Claude Code	`claude mcp add termcp -- npx -y @open-mcp-ai/termcp daemon stdio`
Codex	`codex mcp add termcp -- npx -y @open-mcp-ai/termcp daemon stdio`
Gemini CLI	`gemini mcp add termcp npx -- -y @open-mcp-ai/termcp daemon stdio`

2 · 配置文件

{
  "mcpServers": {
    "termcp": {
      "command": "npx",
      "args": ["-y", "@open-mcp-ai/termcp", "daemon", "stdio"]
    }
  }
}

其他安装方式 — npm / Go / Docker / 预构建二进制文件

	命令
npm	`npm i -g @open-mcp-ai/termcp` — 安装 `termcp` 命令；安装后，从上方的所有代码片段中移除 `npx -y @open-mcp-ai/termcp`，改用 `termcp`。封装程序：open-mcp-ai/Termcp-npm。
Go	`go install github.com/open-mcp-ai/termcp@latest` — 在中国大陆使用 `GOPROXY=https://goproxy.cn,direct`；也可作为模块使用（`go get github.com/open-mcp-ai/termcp`）。
Docker	`docker 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`
二进制文件	预构建版本 — `amd64` / `arm64` 架构的 `linux` / `darwin` / `windows` 版本，每种架构和系统各有一个静态文件。

npm 封装程序会下载匹配的预构建二进制文件（可通过 TERMCP_VERSION、TERMCP_MIRROR、 TERMCP_BIN、TERMCP_SKIP_DOWNLOAD 覆盖）。标志： docs/cli.md。Docker 配置、Compose 和无需令牌的环回设置：docs/deploy.md。

HTTP 传输，适用于某个实例已在某处响应的情况（npx -y @open-mcp-ai/termcp）：

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

Docker 中的客户端可通过 http://host.docker.internal:18765/stream（macOS/Windows）或主机的 LAN IP 访问；同一网络上的其他容器可通过 http://termcp:18765/stream 访问。旧版 SSE 使用 http://localhost:18765/sse——仅使用 /sse，JSON-RPC 会自动发送到 /message。使用 --auth-token 时，请添加 bearer 标头："headers": {"Authorization": "Bearer <token>"}。

文档


`docs/cli.md`	所有标志和子命令、能力门控、身份验证。
`docs/clients.md`	四种入口的端到端说明：MCP 传输、stdio 桥接、身份验证、REST 示例和单工具界面。
`docs/deploy.md`	Docker、多阶段构建、Compose、纯 API 构建。
`docs/protocol.md`	`TERM/1` 规范：线缆格式、状态码、标头、19 条指令、三个门控。
`docs/capabilities.md`	完整的能力范围和安全模型。
`docs/api.md`	REST 端点、WebSocket 帧、定位符解析。
`docs/capabilities.md`	完整的能力范围和安全模型。
`docs/architecture.md`	会话内核、入口、存储。
`docs/design/`	设计记录：Web UI、资源模型、会话存储、字体栈、移动终端。
`CHANGELOG.md`	发行说明。