Omarchy MCP

奥马奇·麦克普

一个Claude Code插件，它公开了 奥马奇手册 作为本地MCP服务器。直接在Claude对话中提供对手册所有43个部分的可搜索、缓存访问。

作者 阿尔多·W·查孔(@Aldochaconc)

______________________________________________________________________

它做什么

• 在本地获取并缓存Omarchy手册（无重复的网络调用）
• 公开5个MCP工具，用于从Claude内部查询文档
• 支持按需刷新以获取文档更新
• 启用所有缓存部分的全文搜索

______________________________________________________________________

安装

/plugin marketplace add /path/to/omarchy-mcp
/plugin install omarchy-mcp@omarchy-mcp-dev

重新启动克劳德代码。然后预加载完整的手动缓存（一次性）：

fetch_all_sections

______________________________________________________________________

MCP工具

list_sections

列出Omarchy手册的所有43个部分及其slug和缓存状态。

没有参数。

输出示例：

- **Welcome to Omarchy** — `welcome-to-omarchy` (cached 2026-03-07)
- **Hotkeys** — `hotkeys` (not cached)
...

______________________________________________________________________

read_section

阅读特定章节的全部内容。

例子：

read_section { "slug": "hotkeys" }
read_section { "slug": "neovim", "refresh": true }

______________________________________________________________________

search_docs

在所有缓存部分进行全文搜索。最多返回5场比赛，并按相关性排名摘录。

注： 仅搜索本地缓存中已有的部分。跑 fetch_all_sections 首先是全面覆盖。

例子：

search_docs { "query": "clipboard" }
search_docs { "query": "fingerprint auth" }

______________________________________________________________________

fetch_all_sections

从实时网站获取并缓存所有43个部分。运行一次以构建本地索引，或使用 refresh: true 当文档更新时。

例子：

fetch_all_sections {}
fetch_all_sections { "refresh": true }

______________________________________________________________________

cache_status

显示缓存了哪些部分以及上次获取这些部分的时间。

没有参数。

输出示例：

# Cache Status

43/43 sections cached
Last full fetch: 2026-03-07

- [x] Welcome to Omarchy — last fetched 2026-03-07
- [x] Hotkeys — last fetched 2026-03-07
...

______________________________________________________________________

缓存

内容存储在 server/.cache/ 在插件目录中。每个部分都是一个JSON文件：

server/.cache/
├── index.json          # Metadata index
├── hotkeys.json
├── neovim.json
└── ...

缓存路径可以通过以下方式覆盖 OMARCHY_CACHE_DIR 环境变量。

______________________________________________________________________

发展

cd server
npm install
npm run build    # Compile TypeScript → dist/
npm start        # Run the server directly

要迭代插件：

/plugin uninstall omarchy-mcp@omarchy-mcp-dev
# make changes, then:
npm run build
/plugin install omarchy-mcp@omarchy-mcp-dev
# restart Claude Code

______________________________________________________________________

手册章节

______________________________________________________________________

许可证

麻省理工学院