AI导哈

主题管理协议服务器

Omarchy MCP是一个用于集成Omarchy桌面环境主题管理与AI助手的协议服务器，支持主题列表查询、切换、预览、安装和移除等功能。

  • by ServiceStack
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ServiceStack/omarchy-mcp

使用说明

奥马奇MCP

用于集成的模型上下文协议（MCP）服务器 奥马奇 使用Claude等AI助手进行桌面环境主题管理。

概述

Omarchy MCP使AI助手能够管理Omarchy中的主题，Omarchy是一个Linux桌面环境，支持广泛的主题定制，包括配色方案、背景和UI元素。

借助此MCP服务器，AI助手可以：

  • 列出具有灵活过滤功能的主题（已安装、可用、内置、可移动）
  • 查询当前活动的主题
  • 在已安装的主题之间切换
  • 在应用主题图像之前预览它们
  • 从GitHub存储库安装新主题
  • 删除已安装的额外主题
  • 旋转背景图像

Youtube视频

安装

在llms.py中使用

或将服务器配置粘贴到 llms.py MCP服务器:

姓名： omarchy-mcp

{
  "description": "Manage Omarchy Desktop Themes",
  "command": "uvx",
  "args": [
    "omarchy-mcp"
  ]
}

开发服务器

对于开发，您可以使用以下命令运行此服务器 uv:

{
  "mcpServers": {
    {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/ServiceStack/omarchy-mcp",
        "omarchy-mcp"
      ]
    }
  }
}

克劳德桌面版

添加到您的Claude Desktop配置文件中：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "omarchy": {
      "description": "Manage Omarchy Desktop Themes",
      "command": "uvx",
      "args": [
        "omarchy-mcp"
      ]
    }
  }
}

系统提示

通过配置自定义系统提示，您可以使您的AI成为一个更愉快、更有个性的Omarchy助手。下面的链接系统提示创建了“Archy”，这是一个友好的对话助手，非常了解Omarchy，对语音命令反应自然。

system-prompt.txt

可用工具

omarchy_theme_list

列出具有灵活过滤选项的Omarchy主题。

参数：

  • filter （可选）：按类型筛选主题
    • "INSTALLED" （默认）-所有已安装的主题
    • "ALL" -所有可用主题（已安装和未安装）
    • "CURRENT" -仅当前活动的主题
    • "BUILT_IN" -仅内置主题
    • "CAN_REMOVE" -仅安装了可以删除的额外主题
    • "CAN_INSTALL" -只有可用于安装的主题
  • scheme （可选）：按配色方案过滤
    • "ANY" （默认）-所有配色方案
    • "LIGHT" -仅以灯光为主题
    • "DARK" -仅限黑暗主题

退货： 带有状态指示器的主题名称列表（当前、内置、已安装）

omarchy_theme_set

将主题应用于Omarchy桌面。

参数：

  • theme （必填）：要应用的主题名称（支持部分/不区分大小写的匹配）

退货： 应用主题的预览图像

omarchy_theme_bg_next

旋转到当前主题中的下一个背景图像。

退货： 新的背景图像

omarchy_preview_theme

下载并返回主题的预览图像，而不应用它。

参数：

  • name （必填）：主题名称（支持部分/不区分大小写的匹配）

退货： 主题预览图片

omarchy_install_theme

从GitHub存储库安装一个新的额外/社区主题。安装主题会自动将其设置为当前主题。

参数：

  • name （必填）：要安装的主题名称

退货： 安装后的主题预览图像

omarchy_remove_theme

卸载以前安装的额外/社区主题。无法删除内置主题。

参数：

  • name （必填）：要卸载的主题名称

退货： 状态消息

主题匹配

主题名称支持灵活匹配：

  • 不区分大小写：《东京之夜》、《东京之晚》和《东京之晚上》都匹配
  • 部分匹配：“东京”匹配“东京之夜”
  • 标点不敏感：《东京之夜》、《东京夜》和《东京夜

需求

  • python：3.10、3.11或3.12
  • 奥马奇：必须安装在系统上
  • Linux：配备Wayland显示服务器

依赖项

  • fastmcp>=0.1.0 -MCP服务器框架
  • aiohttp -用于下载预览图像的异步HTTP客户端

内置主题

Omarchy有14个内置主题：

  • 东京之夜
  • 猫布丁
  • 缥缈
  • Everforest
  • GruvBox 的
  • 黑客
  • 大阪翡翠
  • 神奈川
  • 北
  • 哑光黑
  • 意式特浓咖啡
  • Flexoki灯
  • 玫瑰松
  • 卡布奇诺拿铁

额外主题

超过100个额外的社区主题可供安装，包括各种深色和浅色偏好的配色方案。

发展

设置

git clone https://github.com/ServiceStack/omarchy-mcp.git
cd omarchy-mcp
pip install -e ".[dev]"

运行测试

pytest tests -v

装订和格式化

ruff check .
ruff format .

建筑

python -m build

许可证

BSD-3条款

相关 MCP