Repository navigation
docs(windows): 修正 host 找不到 uvx 的排查步驟與 JSON 反斜線說明 - #25
Merged
Merged
Conversation
用戶反映 PowerShell 找得到 uvx，但 host 啟動 FinMind-MCP 子行程時找不到。
修改檔案：
- install/windows.md「host 啟動 server 失敗」FAQ 改寫成四步驟：
1. 查路徑：where.exe / (Get-Command uvx).Source，註明 PowerShell 的 where
是 Where-Object 別名；多行取第一行
2. 新增各安裝方式的常見路徑表。原文寫「通常是 .local\bin\uvx.exe」，
但本頁推薦的 winget 安裝實際落在 AppData\Local\Microsoft\WinGet\Links，
照抄會填錯路徑
3. 提醒 command 不會展開 %USERPROFILE% 等環境變數
4. 先用 & "完整路徑" finmind-mcp --help 在 PowerShell 驗證路徑
5. JSON 反斜線：單一反斜線＝不合法 JSON（\U、\. 是非法跳脫），會讓 host
讀不到所有 MCP server；可改用正斜線；範例改為 winget 路徑
6. 新增 python -m json.tool 驗證設定檔合法
7. Codex TOML：用單引號字串避免 \U 被當 unicode 跳脫
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
linsamtw
changed the title
linsamtw
changed the title
2 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
用戶反映 PowerShell 找得到
uvx，但 host（Claude Desktop 等）啟動 FinMind-MCP 子行程時找不到。問題
install/windows.md寫「通常會是C:\Users\<帳號>\.local\bin\uvx.exe」，但本頁首推的winget install實際路徑是AppData\Local\Microsoft\WinGet\Links\uvx.exe，用戶照抄就會填錯。where.exe的結果（單一反斜線）＝不合法 JSON」的後果，也沒有驗證方法。修改（只有
install/windows.md）where與where.exe不同、多行取第一行、command不會展開%USERPROFILE%\要寫成\\，或改用正斜線；寫錯會讓 host 連其他 MCP server 都讀不到python -m json.tool驗證設定檔驗證
json.loads解析通過；正斜線寫法也通過；單一反斜線確認會拋出Invalid \escapetomllib解析通過；雙引號＋單一反斜線確認會報錯pytest36 passed（merge 之後才推上這個分支的 commit 29cbfcc，Claude Desktop
.mcpb一鍵安裝，未包含在本 PR，已改開新 PR。）