Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

test: MCP tests fail when the developer's ~/.claude.json has MCP servers (HOME is not sandboxed)

Open Beginner friendly
#1,386 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
78/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
typescript
Domain
cli, testing-qa

Research direction

Start with test/preload.ts and inspect how MCP discovery obtains HOME, then review test/mcp/headers.test.ts and test/server/httpapi-mcp.test.ts. Ensure the suite uses an isolated home directory so developer MCP configuration cannot affect discovery. Run those tests with and without a populated real ~/.claude.json, then verify the reported 15/15 result.

Written by the indexing model from the issue text.

Description

Found while running the full suite for the v0.12.4 release.

test/mcp/headers.test.ts (5 tests) and test/server/httpapi-mcp.test.ts ("serves status endpoint") fail on any machine whose real ~/.claude.json has an entry under mcpServers. MCP discovery reads that file from the real $HOME, so the discovered server is created alongside the test's own servers: it has no requestInit, which breaks the headers assertions, and it changes the status endpoint's result.

test/preload.ts sandboxes the XDG directories but not HOME, so other home-directory config sources may leak the same way.

Reproduced on main (93fe816e20). With HOME pointed at an empty temporary directory, the same three files pass (15/15).

Suggested fix: point HOME (or the discovery's home-directory lookup) at a temporary directory in test/preload.ts, or have MCP discovery honour a test override, so the suite never reads the developer's own editor and assistant configs.

Dominant language
TypeScript
Stars
815
Forks
135
Avg merge
1d 12h
Merged PRs (30d)
58

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from AltimateAI/altimate-code

All issues in AltimateAI/altimate-code

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.