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.