Enables integration with LangChain agents for orchestrating medical AI workflows and building agentic applications on top of the MedX platform's diagnostic and healthcare capabilities.
Provides access to OpenAI's API for AI-powered medical consultations, enabling clinical decision support, diagnostic assistance, and personalized healthcare recommendations through chat-based interactions.
MedX MCP Server
AI-powered clinical agentic platform featuring MedX-powered AI Agents and HealthOS, delivering advanced diagnostic support and personalized healthcare.
Overview
The MedX MCP Server provides a RESTful API for AI agents to access medical AI capabilities. It supports:
Advanced diagnostic support
Personalized healthcare recommendations
Clinical decision support
AI-powered medical consultations
Features
✅ RESTful API with Server-Sent Events (SSE) streaming
✅ Asynchronous tool execution
✅ Session management for conversations
✅ Idempotent requests
✅ Tool cancellation
✅ Health and readiness checks
Quick Start
Server Setup
Server runs on http://localhost:8000 by default.
Client Usage
Documentation
CLIENT_USAGE_GUIDE.md - Complete client usage guide
API_DOCUMENTATION.md - Full API reference
API_QUICK_REFERENCE.md - Quick API cheat sheet
AGENT_INTEGRATION_GUIDE.md - How agents integrate with MCP server
ARCHITECTURE_EXPLANATION.md - Server architecture details
Client SDK
The project includes a Python client SDK in the client/ directory:
See CLIENT_USAGE_GUIDE.md for complete examples.
Examples
examples/simple_client_example.py- Basic client usageexamples/langchain_integration_example.py- LangChain agent integration
API Endpoints
GET /mcp/manifest- Discover server capabilities and toolsPOST /mcp/execute- Execute a toolGET /mcp/stream/{call_id}- Stream resultsPOST /mcp/cancel/{call_id}- Cancel a callGET /healthz- Health checkGET /readyz- Readiness check
Configuration
Environment variables:
OPENAI_API_KEY- OpenAI API key (required)MCP_SERVER_TOKEN- Bearer token for authentication (default: "super-secret-token")SERVER_HOST- Server host (default: "0.0.0.0")SERVER_PORT- Server port (default: 8000)
License
[Add your license here]
Support
For issues and questions, see the documentation files or create an issue.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Provides AI-powered medical consultation and clinical decision support through diagnostic analysis and personalized healthcare recommendations using OpenAI integration.