使用
macOS arm64
需要先準備
- 執行環境:
python>=3.11 - 系統套件:
git
git clone FlowState 儲存庫
git clone https://github.com/dialectforge/FlowState.git FlowState && ls FlowState/mcp-server建立 venv 並 pip install -e mcp-server
cd FlowState && /opt/homebrew/bin/python3 -m venv .venv && .venv/bin/python -m pip install -e mcp-server
加進你的 agent
claude mcp add flowstate -- env 'FLOWSTATE_DB=<FLOWSTATE_DB>' '<install-folder>/FlowState/.venv/bin/python' -m flowstateClaude Desktop、Cursor 等用戶端用的 JSON
{
"mcpServers": {
"flowstate": {
"command": "env",
"args": [
"FLOWSTATE_DB=<FLOWSTATE_DB>",
"<install-folder>/FlowState/.venv/bin/python",
"-m",
"flowstate"
]
}
}
}請把 <FLOWSTATE_DB> 換成你自己的路徑。 請把 <install-folder> 換成你執行安裝步驟的資料夾。
在 AI App 中將 FlowState 資料夾的 .venv/bin/python -m flowstate 新增為 MCP 伺服器,再呼叫 start_here 工具。
Linux x86_64
需要先準備
- 執行環境:
python>=3.11 - 系統套件:
git
複製 FlowState 儲存庫
git clone https://github.com/dialectforge/FlowState.git FlowState建立 venv 並 pip install -e mcp-server
cd FlowState && python3 -m venv .venv && .venv/bin/python -m pip install -e mcp-server
README 與實測不符之處
- README 寫: manage_todos action="create" in README example
實際可行: 有效動作為 add、list、next 等;create 會傳回驗證錯誤,專案名稱錯誤時 list 會產生 KeyError
確認能用
FlowState/.venv/bin/python -m flowstate --help 2>&1輸出應包含「usage: flowstate」。
加進你的 agent
claude mcp add flowstate -- '<install-folder>/FlowState/.venv/bin/python' -m flowstateClaude Desktop、Cursor 等用戶端用的 JSON
{
"mcpServers": {
"flowstate": {
"command": "<install-folder>/FlowState/.venv/bin/python",
"args": [
"-m",
"flowstate"
]
}
}
}請把 <install-folder> 換成你執行安裝步驟的資料夾。
在 AI App 中將 FlowState 資料夾的 .venv/bin/python -m flowstate 新增為 MCP 伺服器,再呼叫 start_here 工具。
它能做什麼
- 在 AI 應用程式間共享專案記憶已測試
怎麼使用
- 使用
manage_projects工具,以動作create和名稱建立專案。 - 使用
manage_todos工具,以動作add、專案名稱與標題新增待辦事項。 - 讓其他 AI App 指向同一伺服器,以共用相同的專案記憶。
- 使用
- 開始時閱讀簡短的專案摘要已測試
怎麼使用
- 以專案名稱呼叫
start_here工具,取得專案摘要。
- 以專案名稱呼叫
- 記錄決策、變更、問題及待辦事項已測試
怎麼使用
- 以專案名稱、類型(如
decision)與摘要呼叫log_work工具。
- 以專案名稱、類型(如
- 將記憶保存在本機 SQLite 檔案中未測試
pickfit 測到哪一步
macOS arm64
- 可以安裝
- 可以連線
- 4 項功能中 3 項可用
- 可離線使用
Linux x86_64
- 可以安裝
- 可以連線
- 4 項功能中 1 項可用
- 可離線使用
其他系統
Windows:專案說支援,但 pickfit 還沒試過。
適合用來
- 回想專案中正在進行的工作
- 儲存專案決策
- 列出專案的下一個待辦事項
- 查詢某主題的過往決策
- 審查等待核准的項目
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
macOS arm64
MCP 用戶端成功呼叫工具
- 從頭重跑
- 可離線使用
- 檢查於 2026年11月1日
- 版本 2.4.5
MCP 用戶端透過 stdio 連線,列出 12 個工具,呼叫 log_work 也回傳了結果。
測試機器遇到的差異
- README: manage_projects with project param
測試中: create 動作需要 name 欄位,而非 project
Linux x86_64
MCP 用戶端成功呼叫工具
- 從頭重跑
- 可離線使用
- 檢查於 2026年11月1日
- 版本 2.4.5
MCP 用戶端透過 stdio 連線,列出 12 個工具,呼叫 manage_projects 也回傳了結果。
測試機器遇到的差異
- README: .venv/bin/python -m pip install -e mcp-server assumes .venv exists
測試中: 先用 python3 -m venv .venv 建立 venv - README: FLOWSTATE_WORKSPACE env var usage documented but default DB location not obvious
測試中: 預設 SQLite 位於 ~/.local/share/flowstate/flowstate.db,不在工作區;log_work/manage_todos 的工作區名稱必須與專案名稱完全相符