# Local Workspace MCP 本機工作助手：技能書與協作來源

讓 AI 使用自己的本機檔案，完成一份可核對的文件或報表。

## 工坊收錄說明

作品與開源

想把 AI 對話接上本機工作流程的人。

一份使用合成資料製作的報表與檢查紀錄。

在 AI 開發及 AI 導入與驗證公會分享連線方法與去識別測試。

先閱讀文件模式與完整模式的差異，再用合成 CSV 試作。

## 封面與來源署名

作者：Mini

封面插畫：/art/skills/local-workspace-mcp.webp

原作者 GitHub：https://github.com/arumwu/local-workspace-mcp

登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。

原作數據：/api/v1/github/books/local-workspace-mcp/metrics

Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。

## 讀者與格式

本機 MCP 工具

- 需要整理本機文件的人

- 想驗證 MCP 工作流程的 AI 開發者

## 功能與使用範圍

目前為 alpha，來源支援 macOS／Linux，原生 Windows 尚不支援；實際帳號連線與使用環境需自行驗證。

- 本機檔案搜尋與文件產出

- 文件模式與完整工具模式分開選擇

- 透過私人 MCP 通道接入對話

## 開始前準備

- 自己的 macOS 或 Linux 電腦及 Python／uv 環境

- 文件工作需 Docker；依原作說明建立自己的通道與受限金鑰

- 完整模式可執行目前使用者有權執行的操作；先確認所需範圍

## 第一個練習

1. 閱讀安裝與權限說明，選擇符合需求的模式。

2. 依原作文件設定私人通道，只用合成檔案做第一次測試。

3. 請 AI 把一份範例 CSV 整理成報表，核對結果與產出位置。

## 練習成果

一份由合成 CSV 產生、經本人核對數值與位置的本機報表。

## 專案與授權

原作 Repo：https://github.com/arumwu/local-workspace-mcp
從原作建立自己的版本：https://github.com/arumwu/local-workspace-mcp/fork
工坊整合參考：https://github.com/arumwu/local-workspace-mcp
記錄的授權：MIT

## 一起改這本技能書

向原作回報可重現的連線或文件處理問題，附環境與合成案例；保留 Mini 與第三方引擎的來源聲明。

原作 Repo：https://github.com/arumwu/local-workspace-mcp
預設 PR 目標：arumwu/local-workspace-mcp:main
從原作建立自己的版本：https://github.com/arumwu/local-workspace-mcp/fork
原作 PR：https://github.com/arumwu/local-workspace-mcp/pulls

工坊整合參考：https://github.com/arumwu/local-workspace-mcp
工坊整合任務專用 Fork：https://github.com/arumwu/local-workspace-mcp/fork
工坊任務：https://github.com/arumwu/local-workspace-mcp/issues
工坊 PR：https://github.com/arumwu/local-workspace-mcp/pulls
GitHub Milestones：https://github.com/arumwu/local-workspace-mcp/milestones

先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。

以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。

- 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。

### 補一個文件模式的合成案例 · 建議任務

使用合成 CSV 重現本機文件產出與驗證，不讀取真人私有檔案。

- 驗收：列出環境、模式、產出位置及實際檢查；連線失敗保留錯誤，不公開通道金鑰。

Agent Skill：/development/skills/local-workspace-mcp/SKILL.md
協作 JSON：/api/v1/skills/local-workspace-mcp/collaboration

## 參與開發

向原作回報可重現的連線或文件處理問題，附環境與合成案例；保留 Mini 與第三方引擎的來源聲明。

工坊 Issue／PR 協調入口：https://github.com/arumwu/local-workspace-mcp/issues

先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。

要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues

## 閱讀與來源

閱讀原始專案：https://github.com/arumwu/local-workspace-mcp/blob/71dfd5d6c4884c218b0c2365eb68fb8dde5d7cc1/README.md
核對日期：2026-09-24
核對版本：71dfd5d6c4884c218b0c2365eb68fb8dde5d7cc1

- README.md：https://github.com/arumwu/local-workspace-mcp/blob/71dfd5d6c4884c218b0c2365eb68fb8dde5d7cc1/README.md

- LICENSE：https://github.com/arumwu/local-workspace-mcp/blob/71dfd5d6c4884c218b0c2365eb68fb8dde5d7cc1/LICENSE

## 共創原則

GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。

完整結構化目錄：/api/v1/development-map