Мультиагентный MCP-сервер для управления циклом доходов в здравоохранении (RCM)

AI-нативный мультиагентный MCP-сервер для управления циклом доходов (RCM), реализующий проверку права на обслуживание, предварительное разрешение и общий журнал рассуждений на базе Supabase и pgvector.

Обзор архитектуры

                          ┌────────────────────────────┐
                          │    RCM Multi-Agent System  │
                          │   (Eligibility / PriorAuth)│
                          └─────────────┬──────────────┘
                                        │ (SSE / HTTP / stdio)
                          ┌─────────────▼──────────────┐
                          │   FastMCP Server (Port 8000)│
                          │  trace.* | eligibility.*   │
                          │        priorauth.*         │
                          └─────────────┬──────────────┘
                                        │
                 ┌──────────────────────┴──────────────────────┐
                 ▼                                             ▼
     ┌────────────────────────┐                   ┌────────────────────────┐
     │  Supabase Relational   │                   │  pgvector / Semantic   │
     │  (Payers, Coverage,    │                   │  (Historical Clinical  │
     │   Rules, Traces)       │                   │   Precedents & Cases)  │
     └────────────────────────┘                   └────────────────────────┘

Related MCP server: mymedi-ai-mcp-server

1. Настройка базы данных Supabase

Шаг 1.1: Создание проекта Supabase

1. Войдите в Supabase и создайте новый проект.

2. В разделе Настройки проекта -> База данных обратите внимание на URL проекта и API-ключи (anon или service_role).

Шаг 1.2: Включение pgvector и применение схемы

1. Откройте SQL Editor в панели управления Supabase.

2. Скопируйте и вставьте содержимое supabase/schema.sql и выполните его:

   • Включает расширение vector (CREATE EXTENSION IF NOT EXISTS vector;).

   • Создает таблицы: payers, appointments, patient_coverage, benefit_accumulators, payer_pa_rules, pa_requests, agent_trace (только добавление) и escalations.

   • Создает функцию векторного поиска по косинусному сходству match_pa_cases.

Шаг 1.3: Загрузка начальных данных

Вы можете загрузить синтетические данные в Supabase, используя любой из вариантов:

Вариант A (скрипт-сидер на Python): После настройки .env с вашими SUPABASE_URL и SUPABASE_KEY:

python seed_data.py

Вариант B (SQL Editor): В SQL Editor скопируйте и вставьте содержимое supabase/seed.sql и выполните его.

Это загружает:

• 5 страховщиков: Aetna Commercial, Blue Cross Blue Shield, UnitedHealthcare, Medicare Part B, Cigna.

• 5 приемов: Запланированные визиты с целевыми датами обслуживания (DOS).

• Записи о покрытии: Активные и прекращенные полисы для тестирования крайних случаев.

• Накопители льгот: Франшизы, доплаты, сострахование для конкретных кодов CPT.

• Правила и прецеденты PA: Руководства по предварительному разрешению и исторические случаи с эмбеддингами.

2. Конфигурация окружения

Скопируйте .env.example в .env:

cp .env.example .env

Обновите файл .env своими учетными данными:

# Supabase Configuration
SUPABASE_URL=https://<your-project-ref>.supabase.co
SUPABASE_KEY=<your-supabase-service-role-or-anon-key>

# Server Configuration
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=8000

# Optional Embedding Key
OPENAI_API_KEY=

3. Установка

Установите зависимости проекта:

pip install -r requirements.txt

4. Справочник инструментов MCP

A. Общие инструменты трассировки (trace.*)

Используются всеми агентами для ведения журнала решений с возможностью аудита и только добавлением.

B. Инструменты проверки права на обслуживание (eligibility.*)

Проверяет покрытие пациента на фактическую дату обслуживания (DOS) и оценивает стоимость для пациента.

C. Инструменты предварительного разрешения (priorauth.*)

Автоматизирует поиск правил процедуры, поиск прецедентов и подачу клинического обоснования.

5. Запуск MCP-сервера

Вариант A: SSE-транспорт (по умолчанию)

Запускает сервер FastMCP через Server-Sent Events (SSE):

python run_server.py

• SSE-конечная точка будет доступна по адресу: http://localhost:8000/sse

Вариант B: Пользовательский хост/порт или Stdio

Вы можете настроить параметры транспорта напрямую:

# Run over stdio (e.g. for Claude Desktop / CLI clients)
python src/mcp_server/server.py --transport stdio

# Run over SSE on custom port
python src/mcp_server/server.py --transport sse --port 8080

6. Тестирование и проверка

Запустите набор тестов с помощью pytest:

pytest tests/

Ожидаемый вывод:

tests\test_mcp_tools.py ..........                                       [100%]
============================= 10 passed in 0.07s ==============================

7. Подключение к клиентам агентов

Конфигурация Claude Desktop

Добавьте следующее в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "rcm-server": {
      "command": "python",
      "args": ["<path-to-repo>/src/mcp_server/server.py", "--transport", "stdio"]
    }
  }
}