define-xml-mcp-server

TypeScript MCP server for CDISC Define-XML.

Features

• Supports Define-XML 2.0 and 2.1
• Detects Define version and ARM presence from ODM attributes
• Supports both MCP transports:
  • stdio (default)
  • Streamable HTTP (/mcp endpoint)
• Local file-path input only
• Multi-document in-memory cache using document_id
• Response formats:
  • json
  • markdown

Install

npm install

Build

npm run build

Run

stdio (default)

npm run dev

or

node dist/index.js --transport=stdio

Streamable HTTP

node dist/index.js --transport=http --port=3000

Server endpoint:

• POST /mcp

Tool Catalog

Document Tools

• define_load_document
  • Input: file_path, response_format
  • Loads/parses XML and returns document_id
• define_close_document
  • Input: document_id, response_format
  • Removes document from cache
• define_get_metadata_summary
  • Input: document_id, response_format
  • Returns metadata and entity counts

Required List/Get Tools

• Datasets
  • define_list_datasets
  • define_get_dataset
• Variables
  • define_list_variables
  • define_get_variable
• Codelists
  • define_list_codelists
  • define_get_codelist
• ARM
  • define_list_arm_results
  • define_get_arm_result

Search Tool

• define_search

Notes

• ARM is optional. ARM tools return empty results when ARM data is not present.
• All list tools support pagination via offset and limit.