snomed

This MCP server provides access to SNOMED CT terminology services via a set of RPC-style tools. It exposes capabilities to search for concepts by term, retrieve detailed concept information, fetch all descriptions for a concept, obtain concept relationships and hierarchical navigation, and perform searches using Expression Constraint Language (ECL). The server is designed to run with Node.js and can be deployed locally, or to Cloudflare Workers as described in the repository. Use the provided tools to build workflows that integrate SNOMED CT data into your medical informatics apps, clinical decision support, or data curation pipelines.

To use the tools, first ensure the server is running and reachable. You can invoke tools such as search_concepts to find concepts by a query term, get_concept to retrieve detailed information for a specific concept ID, and get_concept_descriptions to list all descriptions for a concept. Relationships and navigation tools let you explore parent/child hierarchies, while search_by_ecl enables you to filter concepts using SNOMED ECL expressions. The server endpoints are surfaced through the MCP RPC interface, so you can structure requests to call the desired tool with appropriate arguments (e.g., term, conceptId, limit, or ECL expression) and process the returned JSON payloads in your application.

Prerequisites

• Node.js 20 or later
• npm or yarn
• Access to clone and build the repository

Installation steps

1. Clone the repository

git clone https://github.com/yourusername/snomed-mcp-server.git
cd snomed-mcp-server

2. Install dependencies

npm install

3. Build the project

npm run build

4. Run locally (development)

npm run dev

Optional: Deploy to Cloudflare Workers

• Install Wrangler and authenticate

npm install -g wrangler
wrangler login

• Deploy (as described in the project documentation)

npm run deploy

Configure Claude Desktop (as per README)

• Edit Claude Desktop configuration to add the server entry (see README for exact JSON snippet).

Tips and common issues

• Ensure Node.js version is 20+ to match prerequisites.
• Use absolute paths in your client configuration when targeting dist/index.js.
• Run npm run build before configuring clients like Claude Desktop to generate the dist files.
• If the MCP server does not appear in Claude Desktop, double-check the config file path and JSON syntax, restart Claude Desktop, and verify the dist/index.js file exists after build.
• For Cloudflare deployment, confirm Wrangler is installed and you are logged in before running npm run deploy.
• The API endpoints rely on the SNOMED International public terminology servers for reference; ensure network access to the Base URL and FHIR URL for proper operation.