mcpField
A
A Better Mcp ssh Server

A Better Mcp ssh Server

本地服务
github.com/zhangyc310开发工具147 周前更新

关于 A Better Mcp ssh Server

mcpssh 是面向需要管理远程服务器交互式 SSH 会话的 AI Agent 的 Go MCP 服务。它通过 PTY 提供持久会话,并提供启动、交互和关闭会话的工具。

主要功能

  1. 01通过 PTY 启动 SSH 会话
  2. 02发送输入并读取会话输出
  3. 03维持持久会话
  4. 04关闭会话并清理资源

适用场景

  1. 01在远程服务器上运行命令
  2. 02响应交互式 Shell 提示
  3. 03通过 SSH 会话执行脚本

MCP 相关

该 MCP 服务提供启动 SSH 会话、与活动会话交互及关闭会话的工具。会话通过返回的 session ID 标识。

配置

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

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

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

详细介绍

项目概览

mcpssh 是一个基于 Go 的模型上下文协议(MCP)服务,旨在为 AI Agent 提供 SSH 会话管理功能。它允许 AI 通过 SSH 与远程服务交互,包括创建持久会话、发送命令,以及通过伪终端(PTY)接口读取输出。

架构与核心组件

项目由一个主文件 mcpssh.go 组成,其中定义了 MCP 服务及其工具。

核心工具
  • start_session:使用 PTY 启动与指定主机的新 SSH 连接,并返回 session_id。
  • interact_session:向活动的 SSH 会话发送输入并读取输出。这支持交互式 shell 使用(例如,处理提示、运行脚本)。
  • close_session:终止活动的 SSH 会话并清理资源。
依赖项
  • github.com/mark3labs/mcp-go:MCP 服务 SDK。
  • github.com/creack/pty:用于管理交互式 SSH 会话的 PTY。
  • github.com/google/uuid:用于生成会话 ID。

构建与运行

前置条件
  • Go 1.25.0 或更高版本。
  • 系统上已安装 ssh。我在 macos 上使用它。
  • ~/.ssh/config 文件
构建命令
go build -o mcpssh

安装

使用 cmd args 安装到 codex

codex mcp add mcpssh -- /your_path_to_mcpssh/mcpssh

gemini 编辑文件 ~/.gemini/settings.json
"mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest"]
    },
    "ssh": {
      "command": "/your_path_to_mcpssh/mcpssh",
      "args": []
    }
  },

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。