starred/spotify-mcp-varunneal

Fork 0

mirror of https://github.com/varunneal/spotify-mcp.git synced 2026-04-26 13:15:50 +03:00

[GH-ISSUE #24] Installation and configuration problems on Windows with Python environment #12

New issue

Open

opened 2026-02-28 15:42:49 +03:00 by kerem · 1 comment

kerem commented

2026-02-28 15:42:49 +03:00

Owner

Originally created by @oddradiocircle on GitHub (May 9, 2025).
Original GitHub issue: https://github.com/varunneal/spotify-mcp/issues/24

The problem I encountered

While trying to set up Spotify's MCP on my Windows 11 with Claude Desktop, I ran into several headaches:

Windows documentation is lacking - important steps are missing
Dependency confusion - unclear whether mcp needs version 1.3.0 or 1.7.1
Couldn't find the run_server entry point
Module wasn't detected properly without manually configuring PYTHONPATH

How I fixed it (in case it helps someone)

I finally got it working by doing this:

Setting up a specific virtual environment:


python -m venv .spotify-env

Installing exactly what it needs there:


pip install spotipy==2.24.0 mcp==1.3.0 python-dotenv>=1.0.1

And in claude_desktop_config.json I put this:

{
  "mcps": {
    "spotify": {
      "command": "C:\\Users\\danie\\mcp-servers\\spotify-mcp\\.spotify-env\\Scripts\\python",
      "args": [
        "-c",
        "import sys; sys.path.insert(0, 'C:\\\\Users\\\\danie\\\\mcp-servers\\\\spotify-mcp\\\\src'); from spotify_mcp import main; main()"
      ],
      "cwd": "C:\\Users\\danie\\mcp-servers\\spotify-mcp",
      "env": {
        "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID_HERE",
        "SPOTIFY_CLIENT_SECRET": "YOUR_SECRET_HERE",
        "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
      }
    }
  }
}

Ideas for improvement

Windows documentation needs some love - clear steps would be nice
An automatic installation script would be great
Clarify which exact versions are needed for mcp and spotipy
A configuration template for each operating system

My setup in case it helps

Windows 11 straight up
Python 3.12
Latest Claude Desktop version

By the way, once configured it works wonderfully! Thanks for the project.

Originally created by @oddradiocircle on GitHub (May 9, 2025). Original GitHub issue: https://github.com/varunneal/spotify-mcp/issues/24 ## The problem I encountered While trying to set up Spotify's MCP on my Windows 11 with Claude Desktop, I ran into several headaches: 1. **Windows documentation is lacking** - important steps are missing 2. **Dependency confusion** - unclear whether `mcp` needs version 1.3.0 or 1.7.1 3. **Couldn't find the `run_server` entry point** 4. **Module wasn't detected properly** without manually configuring PYTHONPATH ## How I fixed it (in case it helps someone) I finally got it working by doing this: 1. **Setting up a specific virtual environment**: ``` python -m venv .spotify-env ``` 2. **Installing exactly what it needs there**: ``` pip install spotipy==2.24.0 mcp==1.3.0 python-dotenv>=1.0.1 ```` 3. **And in `claude_desktop_config.json` I put this**: ```json { "mcps": { "spotify": { "command": "C:\\Users\\danie\\mcp-servers\\spotify-mcp\\.spotify-env\\Scripts\\python", "args": [ "-c", "import sys; sys.path.insert(0, 'C:\\\\Users\\\\danie\\\\mcp-servers\\\\spotify-mcp\\\\src'); from spotify_mcp import main; main()" ], "cwd": "C:\\Users\\danie\\mcp-servers\\spotify-mcp", "env": { "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID_HERE", "SPOTIFY_CLIENT_SECRET": "YOUR_SECRET_HERE", "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback" } } } } ```` ## Ideas for improvement 1. **Windows documentation needs some love** - clear steps would be nice 2. **An automatic installation script** would be great 3. **Clarify which exact versions are needed** for `mcp` and `spotipy` 4. **A configuration template** for each operating system ## My setup in case it helps - Windows 11 straight up - Python 3.12 - Latest Claude Desktop version By the way, once configured it works wonderfully! Thanks for the project.

kerem commented

2026-02-28 15:42:49 +03:00

Author

Owner

@varunneal commented on GitHub (May 9, 2025):

Thank you for opening this issue! I haven't attempted to run this MCP on a Windows machine. That said, did you attempt to use uv to get this MCP working? In the pyproject we have specified the exact dependency version number and UV will automatically spin up the environment with the reqs.

@varunneal commented on GitHub (May 9, 2025): Thank you for opening this issue! I haven't attempted to run this MCP on a Windows machine. That said, did you attempt to use [uv](https://github.com/astral-sh/uv) to get this MCP working? In the pyproject we have specified the exact dependency version number and UV will automatically spin up the environment with the reqs.

No labels

pull-request

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/spotify-mcp-varunneal#12

No description provided.

Rows
Columns