MedX MCP Server

AI-powered clinical agentic platform featuring our 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

# Install dependencies
pip install -r requirements.txt

# Set environment variables
export OPENAI_API_KEY="your-openai-key"
export MCP_SERVER_TOKEN="your-secret-token"

# Run server
python main.py

Server runs on http://localhost:8000 by default.

Client Usage

from client import MCPClient

# Initialize client
client = MCPClient(
    base_url="http://localhost:8000",
    auth_token="your-token"
)

# Discover capabilities
manifest = await client.discover()
print(manifest['description'])

# Call (simplified)
result = await client.call(
    messages=[{"role": "user", "content": "What is anemia?"}]
)

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:

# Install client dependencies
pip install -r client/requirements.txt

# Use in your code
from client import MCPClient

See CLIENT_USAGE_GUIDE.md for complete examples.

Examples

examples/simple_client_example.py - Basic client usage
examples/langchain_integration_example.py - LangChain agent integration

API Endpoints

GET /mcp/manifest - Discover server capabilities and tools
POST /mcp/execute - Execute a tool
GET /mcp/stream/{call_id} - Stream results
POST /mcp/cancel/{call_id} - Cancel a call
GET /healthz - Health check
GET /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.

Quick Start

Server Setup

# Install dependencies pip install -r requirements.txt # Set environment variables export OPENAI_API_KEY="your-openai-key" export MCP_SERVER_TOKEN="your-secret-token" # Run server python main.py

Server runs on http://localhost:8000 by default.

Client Usage

from client import MCPClient # Initialize client client = MCPClient( base_url="http://localhost:8000", auth_token="your-token" ) # Discover capabilities manifest = await client.discover() print(manifest['description']) # Call (simplified) result = await client.call( messages=[{"role": "user", "content": "What is anemia?"}] )