Spark-Liang/mcp-os-server

# 基本用法（stdio模式）
ALLOWED_COMMANDS="ls,cat,echo" uv --project . run mcp-os-server command-server

# 明确指定stdio模式
ALLOWED_COMMANDS="ls,cat,echo" uv --project . run mcp-os-server command-server --mode stdio

# 使用命令特定编码（为不同命令设置不同的字符编码）
ALLOWED_COMMANDS="ls,cat,echo,npm,dir" DEFAULT_ENCODING_npm=utf-8 DEFAULT_ENCODING_dir=gbk uv --project . run mcp-os-server command-server

# 使用默认设置（主机：127.0.0.1，端口：8000）
ALLOWED_COMMANDS="ls,cat,echo" uv --project . run mcp-os-server command-server --mode sse

# 使用自定义主机和端口
ALLOWED_COMMANDS="ls,cat,echo" uv --project . run mcp-os-server command-server --mode sse --host 0.0.0.0 --port 9000

# 使用自定义Web路径
ALLOWED_COMMANDS="ls,cat,echo" uv --project . run mcp-os-server command-server --mode sse --web-path /command-web

# 使用默认设置（主机：127.0.0.1，端口：8000，路径：/mcp）
ALLOWED_COMMANDS="ls,cat,echo" uv --project . run mcp-os-server command-server --mode http

# 使用自定义主机、端口和路径
ALLOWED_COMMANDS="ls,cat,echo" uv --project . run mcp-os-server command-server --mode http --host 0.0.0.0 --port 9000 --path /command-api

# 使用自定义Web路径
ALLOWED_COMMANDS="ls,cat,echo" uv --project . run mcp-os-server command-server --mode http --web-path /command-web

# 基本用法（stdio模式）
ALLOWED_DIRS="/path/to/your/safe/dir" uv --project . run mcp-os-server filesystem-server

# 明确指定stdio模式
ALLOWED_DIRS="/path/to/your/safe/dir" uv --project . run mcp-os-server filesystem-server --mode stdio

# 使用默认设置（主机：127.0.0.1，端口：8000）
ALLOWED_DIRS="/path/to/your/safe/dir" uv --project . run mcp-os-server filesystem-server --mode sse

# 使用自定义主机和端口
ALLOWED_DIRS="/path/to/your/safe/dir" uv --project . run mcp-os-server filesystem-server --mode sse --host 0.0.0.0 --port 9000

# 使用自定义Web路径
ALLOWED_DIRS="/path/to/your/safe/dir" uv --project . run mcp-os-server filesystem-server --mode sse --web-path /filesystem-web

# 使用默认设置（主机：127.0.0.1，端口：8000，路径：/mcp）
ALLOWED_DIRS="/path/to/your/safe/dir" uv --project . run mcp-os-server filesystem-server --mode http

# 使用自定义主机、端口和路径
ALLOWED_DIRS="/path/to/your/safe/dir" uv --project . run mcp-os-server filesystem-server --mode http --host 0.0.0.0 --port 9000 --path /filesystem-api

# 使用自定义Web路径
ALLOWED_DIRS="/path/to/your/safe/dir" uv --project . run mcp-os-server filesystem-server --mode http --web-path /filesystem-web

# 基本用法（stdio模式）
ALLOWED_COMMANDS="ls,cat,echo" ALLOWED_DIRS="/tmp" uv --project . run mcp-os-server unified-server

# 明确指定stdio模式
ALLOWED_COMMANDS="ls,cat,echo" ALLOWED_DIRS="/tmp" uv --project . run mcp-os-server unified-server --mode stdio

# 使用命令特定编码
ALLOWED_COMMANDS="ls,cat,echo,npm,dir" ALLOWED_DIRS="/tmp" DEFAULT_ENCODING_npm=utf-8 DEFAULT_ENCODING_dir=gbk uv --project . run mcp-os-server unified-server

# 使用默认设置（主机：127.0.0.1，端口：8000）
ALLOWED_COMMANDS="ls,cat,echo" ALLOWED_DIRS="/tmp" uv --project . run mcp-os-server unified-server --mode sse

# 使用自定义主机和端口
ALLOWED_COMMANDS="ls,cat,echo" ALLOWED_DIRS="/tmp" uv --project . run mcp-os-server unified-server --mode sse --host 0.0.0.0 --port 9000

# 使用自定义Web路径
ALLOWED_COMMANDS="ls,cat,echo" ALLOWED_DIRS="/tmp" uv --project . run mcp-os-server unified-server --mode sse --web-path /unified-web

# 使用默认设置（主机：127.0.0.1，端口：8000，路径：/mcp）
ALLOWED_COMMANDS="ls,cat,echo" ALLOWED_DIRS="/tmp" uv --project . run mcp-os-server unified-server --mode http

# 使用自定义主机、端口和路径
ALLOWED_COMMANDS="ls,cat,echo" ALLOWED_DIRS="/tmp" uv --project . run mcp-os-server unified-server --mode http --host 0.0.0.0 --port 9000 --path /unified-api

# 使用自定义Web路径
ALLOWED_COMMANDS="ls,cat,echo" ALLOWED_DIRS="/tmp" uv --project . run mcp-os-server unified-server --mode http --web-path /unified-web

# 设置全局默认编码为 UTF-8，但为特定命令设置不同编码
DEFAULT_ENCODING=utf-8 DEFAULT_ENCODING_dir=gbk DEFAULT_ENCODING_chcp=cp936 ALLOWED_COMMANDS="ls,dir,chcp,npm" uv --project . run mcp-os-server command-server

# 假设环境变量设置如下：
# DEFAULT_ENCODING=utf-8
# DEFAULT_ENCODING_npm=utf-8
# DEFAULT_ENCODING_dir=gbk

# 情况1：用户指定编码（最高优先级）
command_execute(command="dir", encoding="cp936")  # 使用 cp936

# 情况2：使用命令特定编码
command_execute(command="dir")  # 使用 gbk（来自 DEFAULT_ENCODING_dir）

# 情况3：使用全局默认编码
command_execute(command="ls")   # 使用 utf-8（来自 DEFAULT_ENCODING）

{
    "type": "text",
    "text": "**exit with 0**"
},
{
    "type": "text",
    "text": "---\nstdout:\n---\n命令输出内容\n"
},
{
    "type": "text",
    "text": "---\nstderr:\n---\n错误输出内容\n"
}

{
    "type": "text",
    "text": "已启动后台进程，ID: 123"
}

{
    "type": "text",
    "text": "ID | 状态 | 开始时间 | 命令 | 描述 | 标签\n---------\n123 | running | 2023-05-06 14:30:00 | npm start | 启动Node.js应用 | nodejs"
}

{
    "type": "text",
    "text": "进程123已被优雅地停止\n命令: npm start\n描述: 启动Node.js应用"
}

[
    {
        "type": "text",
        "text": "**进程123（状态：running）**\n命令: npm start\n描述: 启动Node.js应用\n状态: 进程仍在运行"
    },
    {
        "type": "text",
        "text": "---\nstdout: 匹配内容（根据grep_mode）\n---\n[2023-05-06 14:35:27.123456] 服务器在端口3000上启动\n"
    }
]

{
    "type": "text",
    "text": "**成功清理了1个进程:**\n- PID: 123 | 命令: npm start\n\n**无法清理1个运行中的进程:**\n注意: 无法清理正在运行的进程。请先使用`command_bg_stop()`停止它们。\n- PID: 456 | 命令: node server.js\n\n**清理1个进程失败:**\n- PID: 789 | 原因: 找不到进程"
}

{
    "type": "text",
    "text": "### 进程详情: 123\n\n#### 基本信息\n- **状态**: completed\n- **命令**: `npm start`\n- **描述**: 启动Node.js应用\n- **标签**: nodejs, app\n\n#### 时间信息\n- **开始时间**: 2023-05-06 14:30:00\n- **结束时间**: 2023-05-06 14:35:27\n- **持续时间**: 0:05:27\n
#### 执行信息\n- **工作目录**: /path/to/project\n- **退出码**: 0\n
#### 输出信息\n- 使用`command_bg_logs`工具查看进程输出\n- 示例: `command_bg_logs(pid=123)`"
}

"文件内容"

{
    "/path/to/file1.txt": {
        "success": true,
        "content": "文件1的内容"
    },
    "/path/to/file2.txt": {
        "success": false,
        "error": "文件2读取失败的原因"
    }
}

{
    "format": "JPEG",
    "data": "base64编码的图片二进制数据"
}

[
    {
        "format": "PNG",
        "data": "base64编码的图片1二进制数据"
    },
    {
        "format": "GIF",
        "data": "base64编码的图片2二进制数据"
    }
]

"文件已成功写入: /path/to/new_file.txt"

"目录已成功创建: /path/to/new_directory"

[
    {
        "name": "file1.txt",
        "type": "file",
        "path": "/path/to/list/file1.txt"
    },
    {
        "name": "subdir",
        "type": "directory",
        "path": "/path/to/list/subdir"
    }
]

"文件已成功移动: /path/to/old_name.txt -> /path/to/new_name.txt"

[
    "/path/to/search/script.py",
    "/path/to/search/subdir/another_script.py"
]

{
    "type": "file",
    "size": 1234,
    "created": "2023-10-26T10:00:00.000000",
    "modified": "2023-10-26T11:30:00.000000",
    "accessed": "2023-10-26T12:00:00.000000",
    "permissions": "644",
    "absolute_path": "/path/to/your/file_or_dir"
}

{
    "changes_made": [
        {
            "old": "旧文本1",
            "new": "新文本1",
            "applied": true
        },
        {
            "old": "旧文本2",
            "new": "新文本2",
            "applied": false,
            "error": "未找到匹配的文本"
        }
    ],
    "content_changed": true,
    "message": "文件已成功更新"
}

{
    "server_name": "Filesystem Server",
    "version": "1.0.0",
    "work_dir": "/path/to/current/working/directory",
    "allowed_directories": [
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
    ],
    "capabilities": [
        "fs_read_file",
        "fs_read_image",
        "fs_read_multiple_images",
        "fs_write_file",
        "fs_create_directory",
        "fs_list_directory",
        "fs_move_file",
        "fs_search_files",
        "fs_get_file_info",
        "fs_edit_file"
    ]
}

[
    {
        "type": "text",
        "text": "已在浏览器中打开 Web 管理界面: http://127.0.0.1:[随机可用端口] 🚀"
    }
]

uv run --extra dev python build_executable.py --help