Cortellis MCP Server

by uh-joan
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides access to the Cortellis drug database by Clarivate, enabling search for drug information, development status, and exploration of ontology/taxonomy terms with comprehensive filtering options.

Servidor MCP de Cortellis

Servidor MCP para buscar medicamentos y explorar términos ontológicos en la base de datos Cortellis.

Instalación

# Using npm npm install @uh-joan/cortellis-mcp-server

Inicio rápido

  1. Configure sus variables de entorno:
CORTELLIS_USERNAME=your_username CORTELLIS_PASSWORD=your_password USE_HTTP=true # Optional: run as HTTP server PORT=3000 # Optional: specify port for HTTP server
  1. Ejecutar el servidor:
# As MCP server npx cortellis-mcp-server # As HTTP server USE_HTTP=true PORT=3000 npx cortellis-mcp-server

Herramientas

  1. search_drugs
    • Búsqueda de medicamentos en la base de datos de Cortellis
    • Entradas opcionales:
      • query (cadena) - Consulta de búsqueda sin procesar
      • company (cadena) - Empresa que desarrolla el fármaco
      • indication (cadena) - Indicaciones activas (p. ej., obesidad)
      • action (cadena) - Acción específica del objetivo (por ejemplo, glucagón)
      • phase (cadena) - Estado de desarrollo:
        • Admite formatos cortos y descriptivos:
          • Formato corto: S, DR, CU, C1-C3, PR, R, L, OL, NDR, DX, W
          • Formato descriptivo: “Fase 1 Clínica”, “Fase 2 Clínica”, “Fase 3 Clínica”, “Lanzado”, etc.
        • Admite operadores OR/AND: "C2 OR C3" o "Fase 2 Clínica OR Fase 3 Clínica"
        • Ejemplos:
          • phase: "C3" (formato corto)
          • phase: "C2 OR C3" (formato corto)
          • phase: "Phase 2 Clinical OR Phase 3 Clinical" (formato descriptivo)
          • phase: "C2 AND C3" (utilizando el operador AND)
        • Códigos de estado:
          • S: Suspendido
          • DR: Descubrimiento/Preclínico
          • CU: Clínica (fase desconocida)
          • C1-C3: Fase 1-3 Clínica
          • PR: Preinscripción
          • R: Registrado
          • L: Lanzado
          • OL: Fuera de licencia
          • NDR: No se ha informado de ningún desarrollo
          • DX: Descontinuado
          • W: Retirado
      • phase_terminated (cadena) - Última fase antes de NDR/DX
        • Admite los mismos formatos y operadores que phase
        • Ejemplos:
          • phase_terminated: "C2 OR CR" (formato corto)
          • phase_terminated: "C2" (formato corto)
          • phase_terminated: "Phase 2 Clinical" (formato descriptivo)
          • phase_terminated: "C2 OR C3" (múltiples fases)
      • technology (cadena) - Tecnología de fármacos (por ejemplo, molécula pequeña)
      • drug_name (cadena) - Nombre del medicamento
      • country (cadena) - País de desarrollo
      • offset (número) - Para paginación
    • Devuelve: Respuesta JSON con información del fármaco y estado de desarrollo
  2. explore_ontology
    • Explora los términos de taxonomía en la base de datos de Cortellis
    • Entradas opcionales (se requiere al menos una):
      • term (cadena) - Término de búsqueda genérico
      • category (cadena) - Categoría en la que buscar
      • action (cadena) - Acción específica del objetivo
      • indication (cadena) - Enfermedad/afección
      • company (cadena) - Nombre de la empresa
      • drug_name (cadena) - Nombre del medicamento
      • target (cadena) - Objetivo del fármaco
      • technology (cadena) - Tecnología de fármacos
    • Devuelve: Respuesta JSON con términos de taxonomía coincidentes
  3. get_drug
    • Devolver el registro completo del medicamento con todos los campos disponibles para un identificador determinado
    • Entrada requerida:
      • id (cadena) - Identificador de medicamento
    • Devuelve: Respuesta JSON con registro completo del medicamento
  4. get_drug_swot
    • Devolver el análisis FODA que complementa el registro del medicamento seleccionado
    • Entrada requerida:
      • id (cadena) - Identificador de medicamento
    • Devuelve: Respuesta JSON con análisis FODA para el medicamento
  5. get_drug_financial
    • Devolver comentarios y datos financieros (ventas reales y pronóstico de consenso)
    • Entrada requerida:
      • id (cadena) - Identificador de medicamento
    • Devuelve: Respuesta JSON con datos financieros y comentarios
  6. get_company
    • Devuelve el registro completo de la empresa con todos los campos disponibles para un identificador determinado
    • Entrada requerida:
      • id (cadena) - Identificador de la empresa
    • Devuelve: Respuesta JSON con registro completo de la empresa
  7. search_companies
    • Búsqueda de empresas en la base de datos de Cortellis
    • Entradas opcionales:
      • query (cadena) - Consulta de búsqueda sin procesar
      • company_name (cadena) - Nombre de la empresa a buscar
      • hq_country (cadena) - País de la sede de la empresa
      • deals_count (cadena): recuento de todos los acuerdos distintos en los que la empresa es principal/socio
        • Formato: '<20' para menos de 20 transacciones
        • Formato: '20' o ">20' para más de 20 transacciones (comportamiento predeterminado)
      • indications (cadena) - Los 10 términos de indicación más comunes
      • actions (cadena) - Los 10 términos de acción principales basados en objetivos
      • technologies (cadena) - Los 10 términos tecnológicos más importantes
      • company_size (cadena): el tamaño de una empresa según la capitalización de mercado en miles de millones de dólares
        • Formato: '<2' por menos de $2 mil millones
        • Formato: '2' o ">2' para más de $2 mil millones (comportamiento predeterminado)
      • status (cadena) - Estado más alto de los medicamentos vinculados
      • offset (número) - Para paginación
    • Devuelve: Respuesta JSON con información de la empresa

Características

  • Acceso directo a la base de datos de medicamentos de Cortellis
  • Búsqueda integral del estado de desarrollo de fármacos
  • Exploración de términos de ontología/taxonomía
  • Recuperación de información detallada sobre medicamentos
  • Análisis FODA para medicamentos
  • Datos y previsiones financieras
  • Respuestas JSON estructuradas
  • Compatibilidad con paginación para grandes conjuntos de resultados

Puntos finales de la API HTTP

Cuando se ejecuta en modo HTTP (USE_HTTP=true), los siguientes puntos finales REST están disponibles:

  1. POST /search_drugs
    • Búsqueda de medicamentos con filtros opcionales
    • Cuerpo: objeto JSON con parámetros de búsqueda (ver entradas de la herramienta search_drugs )
  2. POST /explore_ontology
    • Buscar términos de taxonomía
    • Cuerpo: objeto JSON con parámetros de búsqueda (ver entradas de la herramienta explore_ontology )
  3. GET /drug/:id
    • Obtenga el registro completo de medicamentos por identificación
    • Parámetros:
      • id : Identificador del medicamento
  4. GET /drug/:id/swot
    • Obtenga un análisis FODA para un medicamento
    • Parámetros:
      • id : Identificador del medicamento
  5. GET /drug/:id/financial
    • Obtenga datos financieros y pronósticos de un medicamento
    • Parámetros:
      • id : Identificador del medicamento
  6. GET /company/:id
    • Obtenga el registro completo de la empresa por ID
    • Parámetros:
      • id : Identificador de la empresa
  7. POST /search_companies
    • Búsqueda de empresas con filtros opcionales
    • Cuerpo: objeto JSON con parámetros de búsqueda (ver entradas de la herramienta search_companies )

Configuración

Variables de entorno

El servidor requiere credenciales de API de Cortellis:

CORTELLIS_USERNAME=your_username CORTELLIS_PASSWORD=your_password

Instalación en Claude Desktop

Antes de comenzar, asegúrese de que Node.js esté instalado en su escritorio para que npx funcione.

  1. Vaya a: Configuración > Desarrollador > Editar configuración
  2. Agregue lo siguiente a su claude_desktop_config.json :
{ "mcpServers": { "cortellis": { "command": "npx", "args": [ "-y", "@uh-joan/cortellis-mcp-server" ], "env": { "CORTELLIS_USERNAME": "your_username", "CORTELLIS_PASSWORD": "your_password" } } } }
  1. ¡Reinicie Claude Desktop y comience a explorar los datos de desarrollo de fármacos!

Construir (para desarrolladores)

git clone https://github.com/uh-joan/cortellis-mcp-server.git cd cortellis-mcp-server npm install npm run build

Para el desarrollo local:

# Copy example environment file cp .env.example .env # Edit .env with your credentials vim .env # or use your preferred editor # Start the server npm run start

Estibador

docker build -t cortellis-mcp-server . docker run -i --env-file .env cortellis-mcp-server

Licencia

Este servidor MCP tiene licencia MIT.

Descargo de responsabilidad

Cortellis™ es un producto comercial y marca registrada de Clarivate Analytics. Este servidor MCP requiere credenciales válidas de la API de Cortellis para funcionar. Para obtener credenciales y obtener más información sobre Cortellis, visite la página de Cortellis de Clarivate .

Este proyecto no está afiliado, respaldado ni patrocinado por Clarivate Analytics. Todos los nombres de productos, logotipos y marcas son propiedad de sus respectivos dueños.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abra una incidencia para comentar qué desea cambiar.

Control de versiones

Usamos SemVer para el control de versiones. Para ver las versiones disponibles, consulte las etiquetas en este repositorio .

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Permite buscar medicamentos y explorar términos ontológicos en la base de datos Cortellis, proporcionando acceso a información completa sobre el estado del desarrollo de medicamentos con respuestas JSON estructuradas.

  1. Installation
    1. Quick Start
      1. Tools
        1. Features
          1. HTTP API Endpoints
            1. Setup
              1. Environment Variables
              2. Installing on Claude Desktop
            2. Build (for devs)
              1. Docker
                1. License
                  1. Disclaimer
                    1. Contributing
                      1. Versioning
                        ID: aja3irnmpw