# clinicaltrialsgov-mcp-server

Подключает агента к реестру ClinicalTrials.gov для поиска испытаний, чтения протоколов и подбора исследований по диагнозу. Ключ API не требуется.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 98
- Автор: cyanheads
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cyanheads/clinicaltrialsgov-mcp-server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/clinicaltrialsgov-mcp-server

## Что делает

Сервер открывает доступ к базе клинических исследований через семь инструментов и ресурс `clinicaltrials://{nctId}`. Ассистент умеет искать записи по диагнозам, спонсорам, географическим координатам или фазам, запрашивать число совпадений без выгрузки карточек и получать результаты завершённых испытаний.

Инструмент `clinicaltrials_find_eligible` сопоставляет возраст, пол и состояние пациента с открытыми наборами, но не проверяет критерии включения и исключения протокола — финальный скрининг остаётся за врачом. Для работы доступны два режима: локальный запуск через `npx` по протоколу STDIO или прямое подключение к публичной HTTP-точке.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://clinicaltrials.caseyjhand.com/mcp`
- Переменные окружения: `CT_API_BASE_URL`, `CT_REQUEST_TIMEOUT_MS`, `CT_MAX_PAGE_SIZE`, `MCP_LOG_LEVEL`, `MCP_TRANSPORT_TYPE`, `MCP_HTTP_HOST`, `MCP_HTTP_PORT`, `MCP_HTTP_ENDPOINT_PATH`, `MCP_AUTH_MODE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http clinicaltrialsgov-mcp-server https://clinicaltrials.caseyjhand.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env CT_API_BASE_URL=<CT_API_BASE_URL> --env CT_REQUEST_TIMEOUT_MS=<CT_REQUEST_TIMEOUT_MS> --env CT_MAX_PAGE_SIZE=<CT_MAX_PAGE_SIZE> --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> --transport stdio clinicaltrialsgov-mcp-server -- npx -y clinicaltrialsgov-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add clinicaltrialsgov-mcp-server --url https://clinicaltrials.caseyjhand.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add clinicaltrialsgov-mcp-server --env CT_API_BASE_URL=<CT_API_BASE_URL> --env CT_REQUEST_TIMEOUT_MS=<CT_REQUEST_TIMEOUT_MS> --env CT_MAX_PAGE_SIZE=<CT_MAX_PAGE_SIZE> --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> -- npx -y clinicaltrialsgov-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "clinicaltrialsgov-mcp-server": {
            "url": "https://clinicaltrials.caseyjhand.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "clinicaltrialsgov-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "clinicaltrialsgov-mcp-server"
            ],
            "env": {
                "CT_API_BASE_URL": "<CT_API_BASE_URL>",
                "CT_REQUEST_TIMEOUT_MS": "<CT_REQUEST_TIMEOUT_MS>",
                "CT_MAX_PAGE_SIZE": "<CT_MAX_PAGE_SIZE>",
                "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
                "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "clinicaltrialsgov-mcp-server": {
            "type": "http",
            "url": "https://clinicaltrials.caseyjhand.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "clinicaltrialsgov-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "clinicaltrialsgov-mcp-server"
            ],
            "env": {
                "CT_API_BASE_URL": "<CT_API_BASE_URL>",
                "CT_REQUEST_TIMEOUT_MS": "<CT_REQUEST_TIMEOUT_MS>",
                "CT_MAX_PAGE_SIZE": "<CT_MAX_PAGE_SIZE>",
                "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
                "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http clinicaltrialsgov-mcp-server https://clinicaltrials.caseyjhand.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e CT_API_BASE_URL=<CT_API_BASE_URL> -e CT_REQUEST_TIMEOUT_MS=<CT_REQUEST_TIMEOUT_MS> -e CT_MAX_PAGE_SIZE=<CT_MAX_PAGE_SIZE> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -e MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> clinicaltrialsgov-mcp-server npx -y clinicaltrialsgov-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера

## Когда брать
- найти клинические исследования по диагнозу и географическому радиусу
- выгрузить протокол и результаты завершённого испытания по номеру NCT
- подсчитать число подходящих исследований без скачивания полных карточек
- подобрать открытые программы набора под демографические данные пациента

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
