Skip to content

docs: add noisy server troubleshooting#253

Open
haosenwang1018 wants to merge 1 commit intophilschmid:mainfrom
haosenwang1018:docs/troubleshoot-noisy-mcp-language-server
Open

docs: add noisy server troubleshooting#253
haosenwang1018 wants to merge 1 commit intophilschmid:mainfrom
haosenwang1018:docs/troubleshoot-noisy-mcp-language-server

Conversation

@haosenwang1018
Copy link
Copy Markdown

Summary

  • add a README troubleshooting section for noisy MCP servers
  • explain why LSP wrappers / watcher-heavy servers may log to stderr even when tools work
  • point users to mcp-cli --debug / MCP_DEBUG=1 for intentional stderr inspection

Problem

Issue #3 shows a config that works but produces a large amount of stderr noise from mcp-language-server and related wrapped runtimes. Without troubleshooting guidance, users can read that output as a CLI failure even when tool discovery succeeds.

Changes

  • add a dedicated README troubleshooting section for noisy MCP servers
  • describe common categories of startup/shutdown stderr noise
  • explain how to isolate one server and when to treat the logs as server-side chatter rather than a broken CLI config

Fixes #3

Validation

  • git diff --check

Signed-off-by: haosenwang1018 <haosenwang1018@users.noreply.github.com>
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.

Errors with this config

1 participant