Reference Configurations for Claude Desktop MCP

by bcdennis

1k downloads
Not rated
GitHub

About

This is a reference implementation of the mcp config to show different use cases for how to configure MCP servers with an app that hosts an MCP Client (like Claude Desktop)

Details

Author
bcdennis
Downloads
1,022
Categories
Developer Tools

- Jetbrains IDE integration via npx on Windows
- Dockerized MCP server on Windows host
- Dockerized MCP server running inside WSL
- uvx‑packaged MCP server accessed through WSL
- Environment variable support for tokens and ports
- Practical tips for handling changing ports in Jetbrains

What dependencies are needed for the Jetbrains configuration?

Node.js and npx must be installed on Windows, and the MCP Server plugin must be enabled in the Jetbrains IDE. External connections must be allowed in the IDE’s debugger settings.

How do I handle the changing port in Jetbrains?

Jetbrains changes the IDE port on every launch. Instead of updating the Claude config each time (which requires restarting the app), update the Jetbrains IDE port to match the port already set in your Claude configuration.

What environment variables are required for the GitHub MCP server?

The GITHUB_PERSONAL_ACCESS_TOKEN environment variable must be set. In the provided Docker example, the token is passed via -e and referenced in the env block of the config.

How do I connect to a Dockerized MCP server running in WSL?

Use wsl.exe as the command and pass the full docker run command as arguments. For example, the filesystem server uses a bind mount from the WSL filesystem into the container.

What is needed for the uvx‑packaged server in WSL?

You need uvx and a shell inside WSL. The config uses wsl.exe bash -c to invoke uvx with the full path to the binary, along with the appropriate repository path for the git MCP server.

Reference Configurations for Claude Desktop MCP

Connecting Claude Desktop to Jetbrains on Windows Host with node installed in Windows

  "jetbrains": {
      "env": {
          "IDE_PORT": "58682"
      },
      "command": "npx",
      "args": [
          "-y",
          "@jetbrains/mcp-proxy"
      ]
  },
1. Install MCP Server plugin first 2. Go to Settings -> Debugger -> Allow External Connections 3. Update the port to match the config. Note, Jetbrains changes ports every launch (it seems). Editing the Claude config to update the port requires the desktop app to be exited and reopened. Jetbrains IDE's don't, so I usually update Jetbrains to match the Claude config instead of vice versa.

Connecting Claude (in Windows Host) to a dockerized MCP Server (running in Windows Host)

    "github": {
        "command": "docker",
        "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "ghcr.io/github/github-mcp-server"
        ],
        "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "<<YOUR TOKEN>>"
        }

Connecting Claude Desktop (in Windows Host) to dockerized MCP Server (running in WSL)

    "filesystem": {
        "command": "wsl.exe",
        "args": [
            "docker",
            "run",
            "-i",
            "--rm",
            "--mount",
            "type=bind,src=<<desired directory>>,dst=/projects",
            "mcp/filesystem",
            "/projects"
        ]
    }

Connecting Claude Desktop (in Windows Host) to uvx packaged MCP Server (running in WSL)

```json "git": { "command": "wsl.exe", "args": [ "bash", "-c", "<<full path to uvx>> mcp-server-git --repository <<path to your repo>>" ] },
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.