Windsurf

Configure Clinical Terminology MCP servers in Windsurf.

Windsurf is an AI-powered IDE that supports MCP servers through a JSON configuration file.

Config File Location

OS	Path
macOS	`~/.windsurf/mcp_config.json`
Linux	`~/.windsurf/mcp_config.json`
Windows	`%USERPROFILE%\.windsurf\mcp_config.json`

Basic Setup

Create or edit ~/.windsurf/mcp_config.json:

{
  "mcpServers": {
    "snomed": {
      "command": "/usr/local/bin/snomed-mcp"
    }
  }
}

Complete Configuration

All seven servers:

{
  "mcpServers": {
    "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:

Server	Environment Variables
ICD-11	`ICD11_CLIENT_ID`, `ICD11_CLIENT_SECRET`
LOINC	`LOINC_USERNAME`, `LOINC_PASSWORD`
UMLS	`UMLS_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:

{
  "mcpServers": {
    "snomed": {
      "url": "https://your-server.com/mcp",
      "transport": "streamable-http"
    }
  }
}

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