de en ja ko ru zh

Tunnel Manager

Name: Tunnel Manager
Author: Knuckles-Team

by Knuckles-Team

Overview Schema Related Servers Score Discussions

Python

Hybrid

Tunnel Manager

CLI 或 API | MCP | Agent

PyPI - Version MCP Server PyPI - Downloads GitHub Repo stars GitHub forks GitHub contributors PyPI - License GitHub GitHub last commit (by committer) GitHub pull requests GitHub closed pull requests GitHub issues GitHub top language GitHub language count GitHub repo size GitHub repo file count (file type) PyPI - Wheel PyPI - Implementation

版本：3.1.0

文档 —— 有关 API、CLI、MCP 与 Agent 界面的安装、部署和使用说明，均维护在官方文档中。

Related MCP server: mcp-ssh

概览

Tunnel Manager 是一个生产级的 Agent 与 Model Context Protocol（MCP）服务器，旨在直接与 Create SSH Tunnels to your remote hosts and host as an MCP Server for Agentic AI! 对接。

主要功能

统一的操作路由 MCP 工具： 通过把方法分组为经过优化且可开关的工具模块，最大限度减少 LLM 上下文中的 token 开销，并消除工具膨胀。
企业级安全： 全面支持 Eunomia 策略、OIDC 令牌委派以及细粒度的执行上下文跟踪。
内置图 Agent： 内置的 Pydantic AI Agent，支持 Agent Control Protocol（ACP）与标准 Web 接口（AG-UI）。
原生遥测与追踪： 开箱即用的 OpenTelemetry 导出，以及原生持有的 Langfuse 追踪。

CLI 或 API

该 Agent 封装了 Create SSH Tunnels to your remote hosts and host as an MCP Server for Agentic AI! API。你可以通过编程方式或通过其内置的可执行入口与它交互。

有关底层 API 封装器、扩展 schema 绑定与开发者 SDK 参考的详细说明，请参阅 docs/index.md。

MCP

此 MCP 服务器采用动态的 Action-Routed 工具来优化 token 开销，并最大程度保证 IDE 兼容性。

可用的 MCP 工具

自动根据实时 MCP 服务器生成 —— 请勿手动编辑。

精简的操作路由工具（`MCP_TOOL_MODE=condensed`）

MCP 工具	切换环境变量	说明
`tm_files`	`FILETOOL`	在远程主机上执行高级文件操作。
`tm_hosts`	`HOSTTOOL`	管理本机主机别名清单。
`tm_inventory`	`INVENTORYTOOL`	针对 YAML 主机组执行批量清单操作。
`tm_operations`	`OPERATIONSTOOL`	操作生命周期与会话管理。
`tm_remote`	`REMOTETOOL`	使用共享连接参数的单一主机 SSH 操作。
`tm_security`	`SECURITYTOOL`	安全扫描与合规检查。
`tm_system`	`SYSTEMTOOL`	通过 SSH 获取远程系统정보。
`tunnel_ingest_hosts`	`INGESTTOOL`	列出由本服务器管理的 SSH 清单，并将其推送到 epistemic-graph 知识图谱（KG）中。

详细的 1:1 API 工具（`MCP_TOOL_MODE=verbose` 或 `both`）

MCP 工具	切换环境变量	说明
`tunnel_manager_add_host`	`HOST_MANAGERTOOL`	调用 add_host 操作。
`tunnel_manager_get_host`	`HOST_MANAGERTOOL`	按别名获取主机配置，若调用者无权限访问该别名则拒绝。
`tunnel_manager_list_hosts`	`HOST_MANAGERTOOL`	列出调用者有权访问的主机别名，机密信息已脱敏。
`tunnel_manager_load_inventory`	`HOST_MANAGERTOOL`	调用 load_inventory 操作。
`tunnel_manager_remove_host`	`HOST_MANAGERTOOL`	调用 remove_host 操作。
`tunnel_manager_save_inventory`	`HOST_MANAGERTOOL`	调用 save_inventory 操作。

8 个 action-routed 工具 · 6 个 verbose 1:1 工具。每个工具默认启用，除非其 <DOMAIN>TOOL 开关被设置为 false；MCP_TOOL_MODE 用于选择工具集（默认 intent —— 六个动词工具、按需加载的细化工具集 · condensed action-routed · verbose 1:1 · both）。自动生成 —— 请勿手动修改。

详细的工具 schema、参数形态与校验约束均保存在 docs/usage.md 中。

动态工具选择与可见性

此 Android MCP 服务器支持在运行时动态选择工具集并过滤可见性，从而让你能限制对外暴露的工具，避免撑爆 LLM 拥有的上下文窗口。

你可以通过多种输入渠道来配置工具过滤：

CLI 参数： 启动时传入 --tools 或 --toolsets（或对应的禁用开关 --disabled-tools 与 --disabled-toolsets）。
环境变量： 这两种渠道定义标准环境变量：
- MCP_ENABLED_TOOLS / MCP_DISABLED_TOOLS
- MCP_ENABLED_TAGS / MCP_DISABLED_TAGS
HTTP SSE 请求头： 在传输初始化期间传入自定义请求头：
- x-mcp-enabled-tools / x-mcp-disabled-tools
- x-mcp-enabled-tags / x-mcp-disabled-tags
HTTP SSE 请求查询参数： 直接将查询参数附加到传输连接 URL 上：
- ?tools=tool1,tool2
- ?tags=tag1

当提供查询字符串或查询参数时，一个无需 LLM 的 知识图谱解析层（使用 DynamicToolOrchestrator）会将查询意图与已知的工具标签、名称或描述进行匹配，并提供安全回退与自动化的 24 小时后台缓存刷新。

MCP 配置示例

安装面向连接器的 [mcp] 附加依赖。 示例使用 tunnel-manager[mcp] 来通过 agent-utilities[mcp] 增加 FastMCP / FastAPI；必需的 Agent Utilities 核心仍会携带 epistemic-graph[full]。[agent-runtime] 附加依赖还会启用模型编排。

stdio Transport（本地 IDE —— Cursor、Claude Desktop、VS Code）

{
  "mcpServers": {
    "tunnel-manager-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "tunnel-manager[mcp]",
        "tunnel-manager-mcp"
      ],
      "env": {
        "MCP_TOOL_MODE": "intent",
        "FILETOOL": "True",
        "HOSTTOOL": "True",
        "INGESTTOOL": "True",
        "INVENTORYTOOL": "True",
        "OPERATIONSTOOL": "True",
        "REMOTETOOL": "True",
        "SECURITYTOOL": "True",
        "SYSTEMTOOL": "True",
        "TUNNEL_IDENTITY_FILE": "~/.ssh/id_ed25519",
        "TUNNEL_INVENTORY_GROUP": "all",
        "TUNNEL_KG_INGEST": "true",
        "TUNNEL_KNOWN_HOSTS": "~/.ssh/known_hosts",
        "TUNNEL_MANAGER_HEALTH_AGGREGATE_S": "3600",
        "TUNNEL_MANAGER_HEALTH_INGEST": "true",
        "TUNNEL_MANAGER_HOSTS": "r510,r710,r820,rw710",
        "TUNNEL_MAX_THREADS": "6",
        "TUNNEL_PARALLEL": "False",
        "TUNNEL_REMOTE_PORT": "22"
      }
    }
  }
}

运行时引用需要支持别名（alias）的启动器，例如 GraphOS。其他启动器必须省略这些条目，并通过自身运行时提供的安全边界注入已解析的值。

Streamable-HTTP Transport（网络 / 生产环境）

{
  "mcpServers": {
    "tunnel-manager-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "tunnel-manager[mcp]",
        "tunnel-manager-mcp",
        "--transport",
        "streamable-http",
        "--port",
        "8000"
      ],
      "env": {
        "TRANSPORT": "streamable-http",
        "HOST": "127.0.0.1",
        "PORT": "8000",
        "MCP_TOOL_MODE": "intent",
        "FILETOOL": "True",
        "HOSTTOOL": "True",
        "INGESTTOOL": "True",
        "INVENTORYTOOL": "True",
        "OPERATIONSTOOL": "True",
        "REMOTETOOL": "True",
        "SECURITYTOOL": "True",
        "SYSTEMTOOL": "True",
        "TUNNEL_IDENTITY_FILE": "~/.ssh/id_ed25519",
        "TUNNEL_INVENTORY_GROUP": "all",
        "TUNNEL_KG_INGEST": "true",
        "TUNNEL_KNOWN_HOSTS": "~/.ssh/known_hosts",
        "TUNNEL_MANAGER_HEALTH_AGGREGATE_S": "3600",
        "TUNNEL_MANAGER_HEALTH_INGEST": "true",
        "TUNNEL_MANAGER_HOSTS": "r510,r710,r820,rw710",
        "TUNNEL_MAX_THREADS": "6",
        "TUNNEL_PARALLEL": "False",
        "TUNNEL_REMOTE_PORT": "22"
      }
    }
  }
}

或者，也可以连接到已预部署的 Streamable-HTTP 实例，并通过 url 指定地址：

{
  "mcpServers": {
    "tunnel-manager-mcp": {
      "url": "http://localhost:8000/tunnel-manager-mcp/mcp"
    }
  }
}

以最小权限的 stdio 子进程运行经过审查的容器镜像（无监听端口，也不发布端口）：

docker run -i --rm \
  --read-only \
  --cap-drop=ALL \
  --security-opt=no-new-privileges \
  --pids-limit=256 \
  --tmpfs /tmp:rw,noexec,nosuid,nodev,size=64m \
  -e TRANSPORT=stdio \
  -e MCP_TOOL_MODE=intent \
  -e FILETOOL=True \
  -e HOSTTOOL=True \
  -e INGESTTOOL=True \
  -e INVENTORYTOOL=True \
  -e OPERATIONSTOOL=True \
  -e REMOTETOOL=True \
  -e SECURITYTOOL=True \
  -e SYSTEMTOOL=True \
  -e TUNNEL_IDENTITY_FILE=~/.ssh/id_ed25519 \
  -e TUNNEL_INVENTORY_GROUP=all \
  -e TUNNEL_KG_INGEST=true \
  -e TUNNEL_KNOWN_HOSTS=~/.ssh/known_hosts \
  -e TUNNEL_MANAGER_HEALTH_AGGREGATE_S=3600 \
  -e TUNNEL_MANAGER_HEALTH_INGEST=true \
  -e TUNNEL_MANAGER_HOSTS=r510,r710,r820,rw710 \
  -e TUNNEL_MAX_THREADS=6 \
  -e TUNNEL_PARALLEL=False \
  -e TUNNEL_REMOTE_PORT=22 \
  registry.example.invalid/tunnel-manager@sha256:<digest> tunnel-manager-mcp

对于容器化网络 HTTP 环境，请通过操作者拥有的部署配置文件提供经过认证的 TLS 入口（或服务器直接 TLS）、严格的 MCP_ALLOWED_HOSTS，以及明确的受信代理对端 CIDR 策略。生成工具不会产生未经认证的非 loopback 非回环监听ter接口。

自动从代码读取的 env 表层（MCP_TOOL_MODE + 包变量）生成 —— 请勿手动编辑。

其他部署选项

tunnel-manager 既可以作为本地 stdio 进程或容器运行，也不必停止在远程网络边界之后。详细的传输契约请参见 Deployment guide。

本地容器 —— 以最小权限的 stdio 子进程形式启动经过审查的不可变镜像，不监听端口，也不发布端口。
远程 URL —— 通过操作者提供的已认证 HTTPS 入口连接。将其 URL、出站身份引用、信任配置和严格的 MCP_ALLOWED_HOSTS 保存在 AgentConfig 中。

主机清单

tunnel-manager 采用一个共享的 YAML 清单（inventory），将短主机名（如 edge-node）映射到其 SSH 连接详情。所有生态表层读取的是同一文件 —— HostManager API、tunnel-manager CLI、MCP 服务器、container-manager-mcp（其 cm_* 主机别名）以及 ssh-bootstrap 技能 —— 因此你只需定义一次即可。

位置 —— ~/.config/agent-utilities/inventory.yml（推荐使用 .yml）。当不存在 .yml 时，同一路径下的旧版 inventory.yaml 仍会被读取，因此现有安装可继续生效。可通过 TUNNEL_INVENTORY 覆盖该路径。

管理方式 —— 使用 inventory 子命令：

tunnel-manager inventory init     # write a commented inventory.yml template (--force to overwrite)
tunnel-manager inventory doctor   # validate hosts/groups; --fix migrates legacy .yaml -> .yml
tunnel-manager inventory show     # print the resolved path + host/group summary

完整的 schema、每个主机字段的详细说明、可复制粘贴的模板以及所有覆盖选项，均收录在 Inventory 指南中。

环境变量

包级环境变量

变量	示例	描述
`HOST`	`127.0.0.1`
`PORT`	`8000`
`TRANSPORT`	`stdio`	选项：stdio、streamable-http、sse
`ENABLE_OTEL`	`True`
`OTEL_EXPORTER_OTLP_ENDPOINT`	`http://localhost:8080/api/public/otel`
`OTEL_EXPORTER_OTLP_PUBLIC_KEY`	secret-injected: 解析
`OTEL_EXPORTER_OTLP_SECRET_KEY`	secret-injected: 处理方案
`OTEL_EXPORTER_OTLP_PROTOCOL`	`http/protobuf`
`EUNOMIA_TYPE`	`none`	选项：none, embedded, remote
`EUNOMIA_POLICY_FILE`	`mcp_policies.json`	// 策略文件
`EUNOMIA_REMOTE_URL`	`http://eunomia-server:8000`
`TUNNEL_IDENTITY_FILE`	`~/.ssh/id_ed25519`	SSH 身份
`DEBUG`	`False`	本文标签为 True 时启用调试输出
`PYTHONUNBUFFERED`	`1`	Set to 1 to make output unbuffered
`TUNNEL_REMOTE_HOST`	—	默认remote host（例如 198.51.100.10） host
`TUNNEL_REMOTE_PORT`	`22`	默认 SSH 端口
`TUNNEL_USERNAME`	—	默认 SSH 用户名 username
`TUNNEL_PASSWORD_REF`	—	env://、vault://、secret:// 或 sqlite:// 引用引用 reference
`TUNNEL_KNOWN_HOSTS`	`~/.ssh/known_hosts`	独立验证的服务器主机密钥 key trust store
`TUNNEL_CERTIFICATE`	—	SSH 证书文件路径 path to SSH certificate
`TUNNEL_PROXY_COMMAND`	—	None. 用于跳板/堡垒主机连接的 SSH ProxyCommand
`TUNNEL_INVESTORY`	—	inventory 文件路径（默认指向 XDG 配置路径） inventory 文件路径
`

变量	描述	默认值
`TUNNEL_INVENTORY`	共享清单文件的路径（优先 `.yml`，`.yaml` 为旧版回退）	`~/.config/agent-utilities/inventory.yml`
`TUNNEL_INVENTORY_GROUP`	默认清单主机组	—
`TUNNEL_PARALLEL`	并行执行批量操作	—
`TUNNEL_MAX_THREADS`	最大并发 SSH 工作线程数	—
`XDG_CONFIG_HOME`	用于解析清单的基础配置目录	`~/.config`

MCP 服务器 / 传输

变量	描述	默认值
`TRANSPORT`	`stdio`、`streamable-http` 或 `sse`	`stdio`
`HOST`	绑定主机（HTTP 传输）	`127.0.0.1`
`PORT`	绑定端口（HTTP 传输）	`8000`
`MCP_TOOL_MODE`	工具表面：`condensed`、`verbose` 或 `both`	`condensed`
`MCP_ENABLED_TOOLS` / `MCP_DISABLED_TOOLS`	逗号分隔的工具允许/拒绝列表	—
`MCP_ENABLED_TAGS` / `MCP_DISABLED_TAGS`	逗号分隔的标签允许/拒绝列表	—
`DEBUG`	详细日志记录	`False`
`PYTHONUNBUFFERED`	无缓冲标准输出（建议在容器中使用）	`1`

工具开关

每个动作路由工具都可以通过其开关环境变量（设置为 false）单独禁用。完整列表见上方的可用 MCP 工具表格（HOSTTOOL、REMOTETOOL、INVENTORYTOOL、OPERATIONSTOOL、 SYSTEMTOOL、FILETOOL、SECURITYTOOL）。

遥测与治理

变量	描述	默认值
`ENABLE_OTEL`	启用 OpenTelemetry 导出	`True`
`OTEL_EXPORTER_OTLP_ENDPOINT`	OTLP 收集器端点	—
`OTEL_EXPORTER_OTLP_PUBLIC_KEY` / `OTEL_EXPORTER_OTLP_SECRET_KEY`	OTLP 认证密钥	—
`OTEL_EXPORTER_OTLP_PROTOCOL`	OTLP 协议（例如 `http/protobuf`）	—
`EUNOMIA_TYPE`	授权模式：`none`、`embedded`、`remote`	`none`
`EUNOMIA_POLICY_FILE`	嵌入式策略文件	`mcp_policies.json`
`EUNOMIA_REMOTE_URL`	远程 Eunomia 服务器 URL	—

代理运行时（仅完整 `[agent]` 运行时）

变量	描述	默认值
`MCP_URL`	代理连接的 MCP 服务器 URL	`http://localhost:8000/mcp`
`PROVIDER`	LLM 提供商（例如 `openai`）	`openai`
`MODEL_ID`	模型 ID（例如 `gpt-4o`）	`gpt-4o`
`ENABLE_WEB_UI`	提供 AG-UI Web 界面	`True`

代理

本仓库包含一个完全集成的 Pydantic AI 图代理。它通过 Agent Control Protocol (ACP) 进行通信，并与 Agent Web UI (AG-UI) 和终端界面无缝交互。

运行代理 CLI

要启动交互式命令行代理：

# Set credentials
export TUNNEL_IDENTITY_FILE="your_value"
export DEBUG="your_value"
export PYTHONUNBUFFERED="your_value"

# Run the agent server
tunnel-manager-agent --provider openai --model-id gpt-4o

Docker Compose 编排

以下 docker/agent.compose.yml 将代理、Web UI 和终端界面配置在一起：

version: '3.8'

services:
  tunnel-manager-mcp:
    image: example/tunnel-manager:mcp
    container_name: tunnel-manager-mcp
    hostname: tunnel-manager-mcp
    restart: always
    env_file:
      - ../.env
    environment:
      - PYTHONUNBUFFERED=1
      - HOST=0.0.0.0
      - PORT=8000
      - TRANSPORT=streamable-http
    ports:
      - "8000:8000"
    healthcheck:
      test: ["CMD", "python3", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 10s
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

  tunnel-manager-agent:
    image: example/tunnel-manager@sha256:<digest>
    container_name: tunnel-manager-agent
    hostname: tunnel-manager-agent
    restart: always
    depends_on:
      - tunnel-manager-mcp
    env_file:
      - ../.env
    command: [ "tunnel-manager-agent" ]
    environment:
      - PYTHONUNBUFFERED=1
      - HOST=0.0.0.0
      - PORT=9002
      - MCP_URL=http://tunnel-manager-mcp:8000/mcp
      - PROVIDER=${PROVIDER:-openai}
      - MODEL_ID=${MODEL_ID:-gpt-4o}
      - ENABLE_WEB_UI=True
      - ENABLE_OTEL=True
    ports:
      - "9002:9002"
    healthcheck:
      test: ["CMD", "python3", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:9002/health')"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 10s
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

详细的图节点架构说明、自定义技能配置和代理跟踪指南可在 docs/deployment.md 中找到。

安全与治理

直接构建于企业级 agent-utilities 核心之上，完全支持标准安全参数：

访问控制与策略执行

Eunomia 策略： 细粒度、策略驱动的工具授权。支持 none、本地 embedded（mcp_policies.json）或集中式 remote 模式。
OIDC 令牌委派： 符合 RFC 8693 令牌交换，用于将认证用户凭据从 Web UI / ACP → Agent → MCP 流转。
作用域凭据： 执行上下文运行限制为特定调用者身份。

运行时安全网格

功能	功能描述	启用方式
工具防护	敏感度检查，并有人工参与验证	默认启用
提示注入防御	输入扫描、重复监控和递归循环阻止	默认启用
上下文安全防护	卡死循环检测和上下文溢出预防性警报	默认启用

安装

选择与您要运行的内容匹配的附加项：

附加项	安装内容	使用场景
`tunnel-manager[mcp]`	面向连接器的 MCP 服务器（`agent-utilities[mcp]` — FastMCP/FastAPI + `epistemic-graph[full]`）	您仅运行 MCP 服务器（最小安装 / 镜像）
`tunnel-manager[agent]`	代理运行时（`agent-utilities[agent-runtime,logfire]` — 模型编排 + `epistemic-graph[full]`）	您运行集成代理
`tunnel-manager[all]`	所有内容（`mcp` + `agent` + `logfire`）	开发 / 两种表面

# Connector-focused MCP server (includes the shared graph engine)
uv pip install "tunnel-manager[mcp]"

# Agent runtime (adds model orchestration to the shared graph engine)
uv pip install "tunnel-manager[agent]"

# Everything (development)
uv pip install "tunnel-manager[all]"      # or: python -m pip install "tunnel-manager[all]"

容器镜像（`:mcp` 与 `:agent`）

一个多阶段 docker/Dockerfile 构建两个大小合适的镜像，通过 --target 选择：

镜像标签	构建目标	内容	入口点
`example/tunnel-manager:mcp`	`--target mcp`	`tunnel-manager[mcp]` — 面向连接器，包含 `epistemic-graph[full]`；无模型编排栈	`tunnel-manager-mcp`
`example/tunnel-manager@sha256:<digest>`	`--target agent`（默认）	`tunnel-manager[agent]` — 代理运行时，模型编排 + `epistemic-graph[full]`	`tunnel-manager-agent`

docker build --target mcp   -t example/tunnel-manager:mcp    docker/   # connector-focused MCP server
docker build --target agent -t example/tunnel-manager:agent-local docker/   # agent runtime

docker/mcp.compose.yml 运行面向连接器的 :mcp 服务器；docker/agent.compose.yml 运行代理（不可变代理摘要）并带有共置的 :mcp 侧车。

知识图谱数据库（`epistemic-graph`）

[mcp] 和 [agent] 都通过所需的 Agent Utilities 核心依赖（epistemic-graph[full]）携带 epistemic-graph 引擎。[mcp] 附加项保持服务器面向连接器；[agent] 额外启用模型编排。本地部署可以使用捆绑的引擎。对于生产或共享状态，请运行 epistemic-graph 作为专用数据库服务，并配置运行时使用它。部署方案（单节点 + Raft HA）、连接配置和架构图记录在 epistemic-graph 部署指南中。

文档

完整文档发布在官方文档站点上，是安装、部署和日常操作的推荐参考。

页面	内容
安装	pip、源码、附加项、预构建 Docker 镜像
清单	共享的 `inventory.yaml` — 默认位置、如何创建、格式、覆盖项
部署	运行 MCP 和代理服务器、Compose、Caddy + Technitium、环境配置
用法	MCP 工具、`HostManager` / `Tunnel` API、CLI
概述	生态角色、分布式 SSH 群扩展、MCP 配置
Teleport 架构	证书、代理和跨操作系统连接模型
概念	概念注册表（`CONCEPT:TUN-*`）

AGENTS.md 是规范的贡献者/代理指南。

维护者

由项目贡献者团队维护。包元数据有意使用角色地址而非个人身份。

贡献

欢迎贡献！请在提交拉取请求前执行本地检查以确保代码质量：

使用 ruff format . 格式化代码
使用 ruff check . 检查代码
使用 mypy . 验证类型安全
使用 pytest 执行测试套件

使用 `agent-utilities-deployment` 部署

使用整合的 agent-utilities-deployment 工作流配置此包。它会选择已安装包、可编辑源码或不可变容器路径；仅在 AgentConfig 中记录运行时机密和 TLS 配置引用；并运行 doctor、注册、策略、可观测性和回滚门禁。请让您的 agent 执行 "使用 agent-utilities-deployment 部署 tunnel-manager"。

安装模式	命令
已安装包	`uv tool install "tunnel-manager[mcp]"`，然后运行 `tunnel-manager-mcp`
可编辑源码	`uv pip install -e ".[agent]"`，然后运行 `tunnel-manager-mcp`
不可变容器	通过操作员选择的编排器部署 `registry.example.invalid/tunnel-manager@sha256:<digest>`

该仓库不嵌入任何部署配置、凭据值、证书路径或环境特定的端点。请在运行时通过 AgentConfig 和已配置的机密提供程序提供这些值。

受治理的能力契约

此包附带一个紧凑的规范技能面，其中专业流程以引用工作流的形式保留。当前的 MCP 工具、技能元数据、connector_manifest.yml、本体、映射、形状、夹具、迁移、工具模式指纹和认证元数据共同构成一份版本化的能力契约。请将它们一起验证；不要依赖过时的工具名称或历史遗留的按任务技能包装器。

运行时端点、凭据、证书信任、租户身份、保留策略和可观测性策略均属于部署输入，绝不会作为打包值。在启用网络传输、连接器摄取、GraphOS 委派或跟踪导出之前，请参阅配置、信任与隐私。

Install Server

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

3dRelease cycle

84Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

MCP SSH Agent
Shell Access Command Line OS Automation
AiondaDotCom
A
license
A
quality
A
maintenance
A server that enables secure interaction with remote SSH hosts through standardized MCP interface, providing functions like listing hosts, executing commands, and transferring files using native SSH tools.
Updated 20 days ago (2026-08-10 14:34 UTC)
7
371
90
MIT
mcp-ssh
Shell Access Command Line Developer Tools
caikiji
A
license
Not graded
quality
D
maintenance
MCP server for SSH remote execution, file transfer, and file editing with automatic backup/trash and ~/.ssh/config integration.
Updated 4 months ago (2026-05-08 17:39 UTC)
117
1
MIT
MCP SSH Manager
Shell Access Command Line Networking & Infrastructure
bysonte
A
license
A
quality
B
maintenance
MCP server for managing remote servers via SSH, enabling command execution, file transfer, rsync, tunnels, health checks, backups, and database operations.
Updated 2 months ago (2026-07-14 00:42 UTC)
17
628
1
MIT
ssh-mcp-toolkit
Shell Access Command Line File Systems
xunuo2345
A
license
Not graded
quality
B
maintenance
MCP server providing safe, persistent SSH sessions to remote machines with multi-hop ProxyJump tunneling, SFTP file transfer, and stored host profiles.
Updated 8 days ago (2026-08-21 17:08 UTC)
MIT

View all related MCP servers

Related MCP Connectors

ScanMalware.com URL Scanner
MCP server for ScanMalware.com URL scanning, malware detection, and analysis.
JFrog Remote MCP Server
MCP Server for JFrog, providing tools for development and artifact management.
network
MCP server for network documentation, generated by doc2mcp.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Knuckles-Team/tunnel-manager'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Tunnel Manager

CLI 或 API | MCP | Agent

概览

主要功能

CLI 或 API

MCP

可用的 MCP 工具

精简的操作路由工具（MCP_TOOL_MODE=condensed）

详细的 1:1 API 工具（MCP_TOOL_MODE=verbose 或 both）

动态工具选择与可见性

MCP 配置示例

stdio Transport（本地 IDE —— Cursor、Claude Desktop、VS Code）

Streamable-HTTP Transport（网络 / 生产环境）

其他部署选项

主机清单

环境变量

包级环境变量

MCP 服务器 / 传输

工具开关

遥测与治理

代理运行时（仅完整 [agent] 运行时）

代理

运行代理 CLI

Docker Compose 编排

安全与治理

访问控制与策略执行

运行时安全网格

安装

容器镜像（:mcp 与 :agent）

知识图谱数据库（epistemic-graph）

文档

维护者

贡献

使用 agent-utilities-deployment 部署

受治理的能力契约

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

MCP SSH Agent

mcp-ssh

MCP SSH Manager

ssh-mcp-toolkit

Related MCP Connectors

Latest Blog Posts

MCP directory API

精简的操作路由工具（`MCP_TOOL_MODE=condensed`）

详细的 1:1 API 工具（`MCP_TOOL_MODE=verbose` 或 `both`）

代理运行时（仅完整 `[agent]` 运行时）

容器镜像（`:mcp` 与 `:agent`）

知识图谱数据库（`epistemic-graph`）

使用 `agent-utilities-deployment` 部署