AI材料柜 MCP（stdio）

通过 MCP 让 Cursor / Claude Desktop 等 AI 助手访问本机 AI 材料柜：检索、读写正文、创建文档等。

产品主站：https://cailiaogui.leanmtech.cn
安装与 Windows 发行包：https://cailiaogui.leanmtech.cn/download/mcp
相关开源：剪藏油猴脚本 ai-cailiaogui-clip

依赖

• 须先安装并启动材料柜（本机 HTTP API，默认 http://127.0.0.1:9000/app/desktop）
• Python ≥ 3.10（源码运行）；或使用官网 Windows zip（内含 local-app-mcp.exe）

工具

工具	说明
search_materials	全库混合检索（FTS + 向量）
search_in_folder	目录范围内检索
list_cabinet_folder	浏览虚拟目录
get_material_meta	材料元信息
read_content / put_content	读写正文
create_doc	新建文档
load_chunks	按 chunk_id 批量拉块正文

环境变量

变量	默认	说明
LOCAL_APP_BASE_URL	http://127.0.0.1:9000/app/desktop	材料柜 API 根（须含 /app/desktop）
LOCAL_APP_HTTP_TIMEOUT_S	30	HTTP 超时（秒）

Host 配置里的 env 优先于本地 .env。示例见 .env.example。

源码安装与运行

pip install -e .
# 另开终端启动材料柜后：
python -m local_app_mcp

MCP Host 配置示例

见 examples/mcp-host.example.json。开发态也可：

{
  "mcpServers": {
    "local-app-cabinet-mcp": {
      "command": "python",
      "args": ["-m", "local_app_mcp"],
      "env": {
        "LOCAL_APP_BASE_URL": "http://127.0.0.1:9000/app/desktop"
      }
    }
  }
}

许可

• 本仓库自有代码：Unlicense（见 LICENSE）
• 「AI 材料柜」「材料柜」等产品名与商标归产品方所有；本开源仓库不授予商标使用权

相关链接

• 产品：https://cailiaogui.leanmtech.cn
• MCP 安装页：https://cailiaogui.leanmtech.cn/download/mcp