Skip to content

docs: add Windows installation guide - #14

Merged
linsamtw merged 1 commit into
masterfrom
docs/windows-install
Jul 17, 2026
Merged

docs: add Windows installation guide#14
linsamtw merged 1 commit into
masterfrom
docs/windows-install

Conversation

@linsamtw

Copy link
Copy Markdown
Contributor

背景

用戶反映不知道如何在 Windows 安裝 FinMind MCP。現有 install/*.md 指令都以 macOS / Linux 為例(bash、export~ 路徑),且假設使用者已有 pipx/uvx,Windows 使用者缺前置步驟。

內容

新增 install/windows.md,涵蓋:

  1. 套件安裝兩條路線:uv(winget / PowerShell 安裝,免先裝 Python,推薦)與 pipx(已有 Python 3.10+,含 pipx ensurepath
  2. Token 設定的 PowerShell 語法($env: / setx),並建議直接填 host 設定檔 env 區塊
  3. 6 個 host 設定檔的 Windows 路徑對照表(%APPDATA% / %USERPROFILE%
  4. 常見問題:
    • GUI 應用(Claude Desktop)讀不到終端機的 PATH → where.exe 查完整路徑填 command
    • JSON 路徑反斜線要寫成 \\
    • 系統匣要 Quit 完全重啟設定才生效
    • 舊版 Windows 10 沒有 winget 的替代方案

修改 8 檔:README host 表格下加 Windows 註記;6 個 host 安裝文件在「安裝套件」段落後各加一行連到 windows.md

純文件變更,不動程式碼與 knowledge/(不影響 wheel 內容與 Custom GPT bundle)。

🤖 Generated with Claude Code

用戶反映不知道如何在 Windows 安裝 FinMind MCP。現有 install/*.md 的
指令都以 macOS / Linux 為前提(bash、export、~ 路徑、假設已有 pipx/uvx),
Windows 使用者缺前置步驟。

新增:
- install/windows.md — Windows 專用安裝指引:
  - 方式 A:winget / PowerShell 安裝 uv(免先裝 Python,推薦)
  - 方式 B:pipx(已有 Python 3.10+),含 pipx ensurepath 與重開視窗提醒
  - Token 設定:PowerShell $env: 與 setx 語法、推薦直接填 host 設定檔 env
  - 6 個 host 設定檔的 Windows 路徑對照表(%APPDATA% / %USERPROFILE%)
  - 常見問題:GUI 應用(Claude Desktop)讀不到終端機 PATH → where.exe 查
    完整路徑填 command、JSON 反斜線要寫 \\、系統匣 Quit 完全重啟、winget 不存在

修改(各加一行指到 windows.md):
- README.md — host 表格下加 Windows 使用者註記
- install/claude-desktop.md、claude-code.md、cursor.md、windsurf.md、
  gemini-cli.md、codex.md — 安裝套件段落後加 Windows 指引連結

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@linsamtw
linsamtw force-pushed the docs/windows-install branch from 1c139df to 03b83ec Compare July 17, 2026 05:05
@linsamtw
linsamtw merged commit 6ca4682 into master Jul 17, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant