# AI材料柜 MCP（stdio）

通过 MCP 让 Cursor / Claude Desktop 等 AI 助手访问本机 [AI 材料柜](https://cailiaogui.leanmtech.cn)：检索、读写正文、创建文档等。

> **产品主站**：https://cailiaogui.leanmtech.cn  
> **安装与 Windows 发行包**：https://cailiaogui.leanmtech.cn/download/mcp  
> **相关开源**：剪藏油猴脚本 [ai-cailiaogui-clip](https://github.com/eblics/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`](./.env.example)。

## 源码安装与运行

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

## MCP Host 配置示例

见 [`examples/mcp-host.example.json`](./examples/mcp-host.example.json)。开发态也可：

```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](./LICENSE)）
- 「AI 材料柜」「材料柜」等产品名与商标归产品方所有；本开源仓库不授予商标使用权

## 相关链接

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