modelcontextprotocol / modelcontextprotocol/servers

No Module Error - Adding MCP server inside Claude Desktop

Open
#1,836 13 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
90.5k
Forks
11.7k
Avg merge
2d 2h
Merged PRs (30d)
5

Description

I am trying to add a MCP server in claude desktop. After properly installing required packages, still getting errors.
Also, I have added a simple MCP server earlier in the claude desktop that is running properly.

Steps that I did for creating and adding the server to claude destop-

  • uv add "mcp[cli]" - To add mcp cli in the project folder
  • uv pip install -r requirements.txt - to install all the required packages
  • uv run mcp install main.py - to add the server inside claude desktop

I am seeing a successful installation message in the terminal, but when I open claude desktop it shows the server fails to run due to a missing module error in the error logs.

ERROR LOGS -
2025-05-19T13:44:08.019Z [TestServer] [info] Initializing server...
2025-05-19T13:44:08.050Z [TestServer] [info] Server started and connected successfully
2025-05-19T13:44:08.052Z [TestServer] [info] Message from client: {"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
Failed to run server: No module named 'fitz'
2025-05-19T13:44:09.663Z [TestServer] [info] Server transport closed
2025-05-19T13:44:09.664Z [TestServer] [info] Client transport closed
2025-05-19T13:44:09.664Z [TestServer] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. console.error('...')in JavaScript,print('...', file=sys.stderr) in python) and it will appear in this log.
2025-05-19T13:44:09.664Z [TestServer] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) {"context":"connection"}
2025-05-19T13:44:09.664Z [TestServer] [info] Client transport closed

Can anyone please help on what I might be doing wrong for this one?

Contributor guide

Open the contributing guide

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.

Research direction

Start by reproducing the reported uv add, uv pip install, and uv run mcp install main.py flow, then inspect the Claude Desktop error log showing No module named 'fitz'. Compare the environment used to install dependencies with the environment used to launch the server; done means the server starts in Claude Desktop without the missing-module error.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
backend, cli
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.