Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

MCP Filesystem UTF-8 Issues on Windows with German Umlaute

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#2,098 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
68/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
node.js, typescript
Lĩnh vực
backend, operating-systems

Hướng nghiên cứu

Bắt đầu bằng cách xác định entry point của MCP Filesystem Server tương ứng với dist/index.js và tái hiện trường hợp ghi trên Windows với “Bäcker” hoặc một chuỗi không phải ASCII khác. So sánh các thiết lập mã hóa được báo cáo của stdin, stdout và stderr, sau đó xác minh rằng việc ghi và đọc các ký tự UTF-8 hoạt động trên Windows mà không chuyển chúng thành dấu chấm hỏi.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

bug server-filesystem

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

Ngôn ngữ chính
JavaScript
Star
91.2k
Fork
11.8k
Merge trung bình
6 giờ 20 phút
Pull request đã merge (30 ngày)
117

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của modelcontextprotocol/servers

Tất cả issue của modelcontextprotocol/servers

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.