docs: fix MCP configuration paths and document platform differences#3500
Closed
Chebaleomkar wants to merge 2 commits intoadenhq:mainfrom
Closed
docs: fix MCP configuration paths and document platform differences#3500Chebaleomkar wants to merge 2 commits intoadenhq:mainfrom
Chebaleomkar wants to merge 2 commits intoadenhq:mainfrom
Conversation
Fixes adenhq#3486. Captures bytes to prevent UnicodeDecodeError and truncates stdout/stderr to 5KB to avoid LLM context overflow.
Fixes adenhq#3484. Updates .mcp.json and .cursor/mcp.json to use uv for cross-platform robustness. Added platform-specific path guidance for Windows in ENVIRONMENT_SETUP.md and improved PYTHONPATH handling.
|
can i work on this to complete the remaining tasks....need assign tag |
|
This PR does not completely solves the issue. I think it occurs mainly because of claude code's bug as well as Python path. I can continue and change the configuration according to related issues #3484 and #2903,needed assignment. @bryanadenhq |
Author
|
I have reproduced the bug and wrote tests . @bryanadenhq @Cn8001 |
|
@Chebaleomkar , sure it was same for me, but sometimes claude code ignores/crashes when "cwd" option is there and that breaks it again as seen in this bug. |
Collaborator
|
Thanks for your contribution. |
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
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.
Description
This PR fixes configuration issues and path documentation for MCP servers, specifically addressing mismatches when running on Windows. It standardized configuration to use
uv runfor better cross-platform compatibility and updates documentation to guide users through environment-specific path requirements.Type of Change
Related Issues
Fixes #3484
Changes Made
.mcp.jsonand.cursor/mcp.jsonto useuv run. This eliminates the need for platform-specific binary paths (e.g.,bin/pythonvsScripts/python.exe).ENVIRONMENT_SETUP.mdexplaining how to configure MCP servers manually on both Windows and Linux/macOS.PYTHONPATHexports in the MCP server configurations to ensure cross-package discovery (linkingcoreandtools) works out of the box.Testing
uv runlogic locally)uv runcommand successfully spawns the MCP server on Windows, whereas the old.venv/bin/pythonpath failed.Checklist
Screenshots (if applicable)
(None required for documentation and configuration fixes)