Clinical Terminology MCP

VS Code

Configure Clinical Terminology MCP servers in VS Code with GitHub Copilot.

Official documentation

VS Code supports MCP servers through GitHub Copilot’s chat feature. Servers are configured in your VS Code settings.json under the github.copilot.chat.mcp.servers key.

Config File Location

OSPath
macOS~/Library/Application Support/Code/User/settings.json
Linux~/.config/Code/User/settings.json
Windows%APPDATA%\Code\User\settings.json

You can also open it from VS Code: Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) and search for “Preferences: Open User Settings (JSON)”.

Basic Setup

Add a single server to your settings.json:

{
  "github.copilot.chat.mcp.servers": {
    "snomed": {
      "command": "/usr/local/bin/snomed-mcp"
    }
  }
}

Complete Configuration

All seven servers:

{
  "github.copilot.chat.mcp.servers": {
    "snomed": {
      "command": "/usr/local/bin/snomed-mcp",
      "env": {
        "SNOWSTORM_BRANCH": "MAIN/SNOMEDCT-US"
      }
    },
    "rxnorm": {
      "command": "/usr/local/bin/rxnorm-mcp"
    },
    "icd10": {
      "command": "/usr/local/bin/icd10-mcp"
    },
    "icd11": {
      "command": "/usr/local/bin/icd11-mcp",
      "env": {
        "ICD11_CLIENT_ID": "your-client-id",
        "ICD11_CLIENT_SECRET": "your-client-secret"
      }
    },
    "loinc": {
      "command": "/usr/local/bin/loinc-mcp",
      "env": {
        "LOINC_USERNAME": "your-username",
        "LOINC_PASSWORD": "your-password"
      }
    },
    "umls": {
      "command": "/usr/local/bin/umls-mcp",
      "env": {
        "UMLS_API_KEY": "your-api-key"
      }
    },
    "ucum": {
      "command": "/usr/local/bin/ucum-mcp"
    }
  }
}

Servers Requiring Credentials

Three servers need credentials configured via environment variables or system keyring:

ServerEnvironment Variables
ICD-11ICD11_CLIENT_ID, ICD11_CLIENT_SECRET
LOINCLOINC_USERNAME, LOINC_PASSWORD
UMLSUMLS_API_KEY

Start with servers that don’t require authentication (snomed, rxnorm, icd10, ucum) and add authenticated services as needed.

Remote / HTTP Setup

Connect to a remote server running in HTTP mode:

{
  "github.copilot.chat.mcp.servers": {
    "snomed": {
      "url": "https://your-server.com/mcp",
      "type": "http"
    }
  }
}

See HTTP Transport for server-side setup and Remote Deployment for deployment guides.