mcpField
M
mcp-sudo

mcp-sudo

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

关于 mcp-sudo

mcp-sudo 面向单用户 Linux 工作站,通过 MCP 执行特权命令,无需反复输入 sudo 密码。它使用由机器 ID 和用户派生的密钥加密保存凭据。

主要功能

  1. 01加密保存 sudo 密码
  2. 02以 sudo 执行 Shell 命令
  3. 03检查是否已保存密码
  4. 04清除已保存密码

适用场景

  1. 01通过 MCP 客户端执行特权命令
  2. 02在会话中避免重复输入 sudo 凭据
  3. 03检查或移除缓存的 sudo 凭据

MCP 相关

该服务提供四种工具,用于保存和检查 sudo 密码、执行特权 Shell 命令,以及清除已保存的密码。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"kamarusama-mcp-sudo": {
"command": "uvx",
"args": [
"mcp-sudo"
]
}
}
}
启动命令uvx mcp-sudo

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

安装包
pypimcp-sudo1.0.1

工具

还没有获取到工具列表

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

详细介绍

mcp-sudo

用于运行 sudo 命令并加密存储密码的 MCP 服务。

提供 4 个工具,用于持久化保存 sudo 密码(使用绑定到机器的密钥加密),并调用特权命令,而无需重新输入凭据。专为单用户 Linux 工作站设计。

📖 阅读泰语版 →


工具

工具用途
store_password保存 sudo 密码(加密,仅需一次)
sudo_exec使用 sudo 运行 shell 命令
has_password检查是否已保存密码
clear_password移除已保存的密码

安全模型

  • 密码使用 Fernet(AES-128-CBC + HMAC-SHA256)加密。
  • 加密密钥由 machine-id + USER 派生而来,绝不会存储在磁盘上。
  • 只有在同一台机器上使用同一用户才能成功解密。
  • 加密数据存储在 ~/.config/claude-sudo-mcp/credential.enc(chmod 600)。

这不是密钥管理器。请将其视为“在这台机器上的本次会话中记住我的 sudo 密码”。如果将 machine-id 复制到另一台机器,或另一位用户读取了 MCP 进程,就可能恢复密码。


安装

cd /path/to/mcp-sudo
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python mcp cryptography

claude mcp add sudo -s user -- \
  /path/to/mcp-sudo/.venv/bin/python /path/to/mcp-sudo/server.py

首次使用时,调用一次 store_password 来缓存凭据。


支持本项目 ❤


联系方式


版权所有 © 2026 likezara™。保留所有权利。 由 Kamaru(笔名)开发。

评论

支持 Markdown

第一次接触 MCP?

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

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