MCP Filesystem UTF-8 Issues on Windows with German Umlaute
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 68/100
- Issue 类型
- 缺陷
- 描述清晰度
- 描述清楚
- 活跃度
- 冷清
- 技术栈
- node.js, typescript
调研方向
首先定位与 dist/index.js 对应的 MCP Filesystem Server 入口点，并使用“Bäcker”或其他非 ASCII 字符串重现 Windows 写入场景。比较报告的 stdin、stdout 和 stderr 编码设置，然后验证在 Windows 上写入和读取 UTF-8 字符时能够正常工作，而不会将其转换为问号。
由索引模型根据 Issue 内容生成。
描述
SOLVED: MCP Filesystem UTF-8 Issues on Windows with German Umlaute
Problem
If you're using the MCP Filesystem Server on Windows and experiencing issues with German umlauts (ä, ö, ü, ß) or other UTF-8 characters being converted to "?" when writing files - this post provides a working solution.
Symptoms:
- Writing "Bäcker" → becomes "B?cker"
- Reading works fine, only writing is affected
- Affects all non-ASCII characters (€, é, ñ, etc.)
Root Cause
The STDIO communication between Claude Desktop and the MCP server doesn't use UTF-8 encoding by default on Windows. The Node.js process needs explicit encoding settings.
Solution
Step 1: Switch from Docker to NPX installation
npm install -g @modelcontextprotocol/server-filesystem
Step 2: Patch the server code
Edit file: %APPDATA%\npm\node_modules\@modelcontextprotocol\server-filesystem\dist\index.js
Add after the imports section:
// UTF-8 Fix for Windows
if (process.platform === 'win32') {
process.stdout.setEncoding('utf8');
process.stderr.setEncoding('utf8');
process.stdin.setEncoding('utf8');
}
Step 3: Update Claude Desktop config
Edit: %APPDATA%\Claude\claude_desktop_config.json
Replace the filesystem server configuration:
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\claude_local",
"C:\\Users\\[YOUR_USERNAME]\\AppData\\Roaming\\Claude"
],
"env": {
"LANG": "de_DE.UTF-8",
"LC_ALL": "de_DE.UTF-8",
"LC_CTYPE": "de_DE.UTF-8"
}
}
Step 4: Restart Claude Desktop
Result
UTF-8 characters now work perfectly: ÄÖÜ äöü ß € ✓
Technical Details
- Tested on Windows 10/11
- Node.js 18+
- MCP SDK v0.6.0
- Solution discovered: June 13, 2025
Full Documentation
Complete documentation with automated patch script available at:
[Link to GitHub Gist or Repository]
Contributing
This fix should ideally be integrated into the official MCP Filesystem Server. I'm planning to submit a PR to the official repository. If you've experienced this issue, please comment to support the PR.
Keywords: MCP, Model Context Protocol, Filesystem Server, UTF-8, Windows, German, Umlaute, Claude Desktop, encoding fix
- 主要语言
- JavaScript
- 星标
- 91.2k
- 派生
- 11.8k
- 平均合并
- 6 小时 20 分钟
- 30 天内合并 PR
- 117
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
modelcontextprotocol/servers 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 62/100
modelcontextprotocol/servers#5156 ·
维护者通常 1 天内回复
-
memory: create_entities, create_relations and add_observations could declare idempotentHint: true可能已有人在做 @syedmustafan 今天认领。 未关闭enhancement v2
难度 1/5 1 小时以内 新手友好度 78/100
modelcontextprotocol/servers#5153 · 2 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
modelcontextprotocol/servers#5134 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 75/100
modelcontextprotocol/servers#5071 · 3 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 85/100
modelcontextprotocol/servers#5059 · 2 条评论 ·
维护者通常 1 天内回复
查看 modelcontextprotocol/servers 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 68/100
keyxmakerx/Chronicle#1532 ·
维护者通常 1 天内回复
-
enhancement feature good first issue
难度 2/5 1-3 小时 新手友好度 72/100
-
bug lsp sev-3
难度 2/5 1-3 小时 新手友好度 78/100
-
学习模式 / 答疑模式在 DSH 0.2.1-rc.2 上必失败：unknown prompt variable "{{cwd}}"可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭
难度 2/5 1-3 小时 新手友好度 90/100
Miaotofu01/Study-Mate#206 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 95/100
Uuriko/project-room#3998 ·
维护者通常 1 天内回复