AI导哈

Ubuntu安全MCP服务器

Percival Ubuntu是一个专注于安全的MCP服务器，用于在严格的Ubuntu安全策略下进行文件管理和命令执行，是percival.OS生态系统的一部分。

  • by bill-kopp-ai-dev
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 bill-kopp-ai-dev/percival-ubuntu-mcp

使用说明

🤖 珀西瓦尔Ubuntu-珀西瓦尔。操作系统MCP

版本0.0.2

📋 描述

珀西瓦尔Ubuntu 是一个专注于安全的MCP服务器，用于安全的Ubuntu操作，专门针对Nanobot代理进行了优化。它允许在严格的安全策略下进行文件管理和命令执行。

此服务器是 珀西瓦尔。操作系统 生态系统，一个为自治、安全和绝对隐私而设计的个人代理操作系统。

🛡️ 珀西瓦尔。操作系统原理

与所有组件一样 percival.OS，此MCP服务器严格遵循我们的核心原则：

  • 隐私与控制：您可以通过策略精确定义代理可以访问的路径和命令(secure, dev).
  • 数据主权代理在Ubuntu主机上本地运行，无需外部中介进行系统管理。
  • 强化安全：路径遍历保护、命令清理（shell注入阻塞）和资源限制，以防止系统耗尽。
  • 透明度：开源且可审计，代理执行的每个操作都有详细的审计日志。

🚀 功能和工具

文件操作

  • ubuntu_list_directory(path)：列出包含元数据的目录内容。
  • ubuntu_read_file(file_path)：读取具有大小验证的文件。
  • ubuntu_write_file(file_path, content, ...)：原子文件写入。

系统操作

  • ubuntu_execute_command(command)：安全执行允许的shell命令。
  • ubuntu_get_system_info()：获取操作系统、内存和磁盘使用情况信息。
  • ubuntu_get_server_status()：返回正常运行时间、活动策略和工具指标。

包管理

  • ubuntu_search_packages(query)：搜索APT存储库。
  • ubuntu_install_package(package_name)：检查安装可用性。

⚙️ percival中的配置。操作系统（纳米机器人）

将以下配置添加到您的 ~/.nanobot/config.json:

{
  "tools": {
    "mcpServers": {
      "percival-ubuntu": {
        "command": "uv",
        "args": [
          "run",
          "--directory",
          "/path/to/percival-ubuntu-mcp",
          "percival-ubuntu-mcp",
          "--policy",
          "secure"
        ],
        "env": {
          "UBUNTU_MCP_RESPONSE_MODE": "compact",
          "UBUNTU_MCP_AUDIT_JSON": "true"
        }
      }
    }
  }
}

🛠️ 开发与测试

此项目使用 uv 用于依赖性管理。

# Sync environment
uv sync --dev

# Verify installation with internal tests
uv run python -m percival_ubuntu_mcp --test

# Test security measures
uv run python -m percival_ubuntu_mcp --security-test

📚 关于项目

此服务器是 珀西瓦尔。操作系统 项目。它是原始的进化 Secure Ubuntu MCP Server，通过Nanobot针对系统编排进行了优化。

与开发❤️ 由珀西瓦尔。操作系统团队

相关 MCP