DS Core Open API

Provides MCP access to patient, document, DICOM study, and digital impression data via open API credentials.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "silverjava-dscore-openapi-mcp": {
      "command": "npx",
      "args": [
        "dscore-openapi-patient-mcp@latest"
      ],
      "env": {
        "GENAPI_API_KEY": "YOUR_GENAPI_API_KEY",
        "GENAPI_BASE_URL": "YOUR_GENAPI_BASE_URL"
      }
    }
  }
}

You can run and use four MCP servers that bridge DS Core Open API data with your AI workflows. Each server exposes specialized patient, document, DICOM study, and digital impression capabilities and can be launched locally via a lightweight MCP client. Set your API credentials, start the desired server, and then interact with its tools through your preferred LLM or automation layer.

How to use

To use an MCP server, prepare your environment with your DS Core Open API credentials and run the server via an MCP client. Start by exporting your credentials, then launch any of the four MCP servers with the provided command. You will then query the server’s tools to search, retrieve, or list data as needed by your AI workflow. Use the dedicated server endpoints through the MCP client in your application logic.

How to install

Prerequisites: Node.js v16 or higher is recommended. Ensure you have network access to the DS Core Open API endpoint you will use.

Step 1: Install dependencies and build the MCP servers

# Install dependencies for the monorepo
npm install

# Build all MCP servers
npm run build

Configuration

All MCP servers require DS Core Open API credentials. You must provide the base URL for the Open API endpoint and an API key for authentication.

export GENAPI_BASE_URL=your_genapi_base_url
export GENAPI_API_KEY=your_genapi_api_key

Usage patterns and start commands

After the credentials are set, start any MCP server using the MCP client. Each server runs independently and exposes its own set of tools for data access and retrieval.

# Run any server with the MCP client
npx dscore-openapi-patient-mcp@latest
npx dscore-openapi-document-mcp@latest
npx dscore-openapi-dcmstudy-mcp@latest
npx dscore-openapi-digitalimpression-mcp@latest

Notes on authentication and encryption

Keep your DS Core credentials secure. Avoid exposing GENAPI_BASE_URL and GENAPI_API_KEY in logs or shared scripts. Prefer runtime environment configuration in your deployment environment.

Available tools

search-patient

Search patients by name or card ID with pagination for efficient discovery.

get-patient

Retrieve complete patient records for detailed review.

list-documents

List documents with patient and time filtering to locate records quickly.

get-document

Get complete document metadata and content URIs for retrieval.

list-dicom-studies

List DICOM studies with customizable metadata masks for imaging data access.

get-dicom-study

Retrieve complete study information including series and instance data.

list-digital-impressions

List dental scans with filtering to manage impressions.

get-digital-impression

Get complete dental scan data and metadata.