文件空间管理工具

Windows系统托盘应用程序,集成LucidLink MCP服务器,支持Claude Desktop、Kiro IDE和VS Code的自动配置,提供SQLite支持的审计跟踪仪表板。

  • by dmcp718
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 dmcp718/lucidlink-mcp-windows

使用说明

适用于Windows的LucidLink MCP

Windows系统托盘应用程序,为Claude Desktop、Kiro IDE和VS Code捆绑LucidLink MCP服务器。包括一个由SQLite和WebWeb2支持的内置审计跟踪仪表板——不需要Docker。

特性

  • 捆绑所有6台LucidLink MCP服务器以进行IDE集成
  • 首次启动时自动配置Claude Desktop、Kiro IDE和VS Code
  • 审计跟踪仪表板:SQLite支持的事件摄取 .lucid_audit 带有交互式WebView2可视化的日志
  • 自动通过以下方式发现已装载的文件空间 lucid CLI(回退到驱动器扫描)
  • 通过按文件空间过滤同时支持多个文件空间
  • 带有烧瓶图标的系统托盘(半满=正常,空=闲置)

捆绑式MCP服务器

服务器 描述
lucidlink-api 文件空间管理-28个工具+api文档搜索
lucidlink connect api S3对象链接——数据存储、外部条目、批量导入
lucidlink文件空间搜索 通过fs索引服务器进行全文搜索(Go+SQLite FTS5)
lucidlink文件空间浏览器 基于Web的文件浏览器生成器
lucidlink审计跟踪 使用OpenSearch进行文件操作分析(15个工具)
lucidlink python-sdk python sdk文档搜索

安装

安装程序(推荐)

下载 LucidLinkMCP-Setup.exe 从 发布.

  • 无需管理员权限--安装到 %LOCALAPPDATA%\Programs\LucidLinkMCP
  • 创建“开始”菜单快捷方式并在登录时自动启动
  • 在“添加/删除程序”中显示
  • LZMA压缩:约107 MB压缩到约27 MB安装程序

便携式ZIP

下载 LucidLinkMCP-Portable.zip 从 发布。随时随地提取并跑步 LucidLinkMCP.exe.

从源头构建

先决条件

  • 视窗 10/11(x64)
  • 去 1.22+
  • Node.js (仅用于构建时间 npm install + npm run build)
  • NSIS 3.x (可选,仅用于创建安装程序)

构建

# Clone
git clone https://github.com/dmcp718/lucidlink-mcp-windows.git
cd lucidlink-mcp-windows

# Full build
powershell -ExecutionPolicy Bypass -File scripts/build.ps1

# Create installer (requires NSIS)
makensis installer/installer.nsi

快速迭代

# Recompile Go tray app only (~2s)
go build -ldflags "-H windowsgui" -o build/LucidLinkMCP/LucidLinkMCP.exe .

用法

首次发射

首次启动时,该应用程序会自动为Claude Desktop配置所有MCP服务器条目,并显示重新启动Claude Desktop的通知。

审计跟踪仪表板

  1. 装载LucidLink文件空间(审核日志显示在 .lucid_audit)
  2. 点击 “启动审核监视器…” 从托盘菜单
  3. 应用程序会自动发现您的文件空间挂载并开始接收事件
  4. 点击 “打开审核仪表板” 查看交互式仪表板
  5. 仪表板每5分钟自动刷新一次;单击“搜索”手动刷新

事件存储在本地 %APPDATA%\LucidLinkMCP\audit-trail.db.

系统托盘

图标 含义
烧瓶(半满紫色) LucidLink MCP正在运行
Flask(空白轮廓) 无活动连接

菜单项

项目 描述
配置Claude Desktop 将MCP服务器条目写入Claude Desktop配置
配置Kiro IDE 将MCP服务器条目写入Kiro IDE配置
配置VS代码 将MCP服务器条目写入VS代码配置
打开审计仪表板 打开SQLite+WebView2审计跟踪仪表板
启动Audit监视器 发现文件空间装载并开始接收事件
停止审核监视器 停止文件监视器

IDE配置路径

IDE 配置文件 密钥
克劳德桌面 %APPDATA%\Claude\claude_desktop_config.json mcpServers
开发 IDE %USERPROFILE%\.kiro\settings\mcp.json mcpServers
VS代码 %APPDATA%\Code\User\mcp.json servers

故障排除

问题 解决方案
Claude看不到MCP服务器 从托盘菜单中单击“配置Claude桌面”并重新启动Claude桌面
找不到文件空间 请确保您的文件空间已装载。观察者寻找 .lucid_audit 目录。
没有出现事件 每10秒轮询一次事件。验证 .lucid_audit 存在并包含日志文件。
仪表板空白 请先启动审核监视器,然后打开仪表板。
WebView 2无法打开 需要Edge WebView 2运行时(预装在Windows 11上)。返回默认浏览器。

项目结构

lucidlink-mcp-windows/
├── main.go                # System tray app entry point
├── audit.go               # SQLite audit engine + filespace discovery
├── dashboard.go           # HTTP API server for dashboard
├── dashboard_html.go      # Embedded HTML/JS dashboard (Chart.js)
├── webview.go             # WebView2 window launcher
├── config.go              # IDE config merging
├── watcher_manager.go     # Multi-filespace watcher manager
├── icon.go                # Programmatic flask ICO generation
├── paths.go               # Windows path resolution
├── help.go                # Help/About dialogs + toast notifications
├── go.mod / go.sum
├── mcp-server/            # MCP server source (TypeScript)
├── scripts/
│   ├── build.ps1          # Full build script (PowerShell)
│   └── download-node.ps1  # Node.js v22.18.0 downloader
├── installer/
│   └── installer.nsi      # NSIS installer script
└── .github/workflows/     # CI/CD (build + signing)

许可证

麻省理工学院