StatPearls

Obtiene información médica y sobre enfermedades revisada por pares de StatPearls.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Servidor MCP de StatPearls

smithery badge

Un servidor de Model Context Protocol (MCP) que obtiene información sobre enfermedades de StatPearls, una fuente confiable de contenido médico revisado por pares.

Dale a tu sistema de IA una fuente confiable de conocimiento médico para su próxima conversación.

Características

  • Busca enfermedades y condiciones médicas en StatPearls
  • Recupera información médica completa y confiable de StatPearls
  • Convierte contenido HTML a Markdown bien formateado para que sea compatible con IA
  • Se integra con modelos de IA mediante el Model Context Protocol

Image

Si aún no tienes un cliente de Model Context Protocol (MCP):

Si eres un usuario ocasional, puedes usar Claude Desktop para comenzar a usar servidores MCP. Es una aplicación de escritorio gratuita y de código abierto que te permite ejecutar servidores MCP localmente y conectarte a ellos.

Si eres un usuario avanzado/desarrollador, te recomiendo usar VSCode con la extensión RooCode, que te permite conectar servidores MCP a tu entorno de desarrollo para posibilidades infinitas.

Instalación

Una vez que tengas un cliente de IA compatible con MCP, puedes ejecutar este servidor localmente.

La forma más fácil de ponerse en marcha es descargar el ejecutable/binario apropiado para tu sistema operativo desde la página de versiones. Esto te dará un ejecutable autónomo que puedes ejecutar sin configuración adicional.

Coloca este ejecutable en el directorio de tu elección. Luego simplemente agrega lo siguiente a tu archivo mcp_settings.json:

Para Windows:

{
  "mcpServers": {
    ...
    "statpearls": {
      "command": "{path_to_executable_here}\\statpearls-mcp.exe"
    },
    ...
  }
}

#### For Mac/Linux:

```json
{
  "mcpServers": {
    ...
    "statpearls": {
      "command": "{path_to_executable_here}/statpearls-mcp"
    },
    ...
  }
}

Instalación mediante Smithery

Para instalar statpearls-mcp para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @jpoles1/statpearls-mcp --client claude

Para desarrolladores:

También puedes ejecutar el servidor desde el código fuente. Esto requiere que Bun esté instalado en tu sistema.

  1. Clona el repositorio
  2. Instala las dependencias (bun install)
  3. Compila el servidor (bun run build)
  4. Ahora puedes agregar el servidor a tu archivo mcp_settings.json:
{
  "mcpServers": {
    ...
    "statpearls": {
      "command": "node",
      "args": [
        "{path_to_proj_here}/dist/index.js"
      ]
    },
    ...
  }
}

Definición de herramientas

El servidor proporciona una única herramienta:

  • statpearls_disease_info: Obtiene información médica completa y confiable sobre enfermedades de StatPearls.

Esquema de entrada

{
  "query": "diabetes",
  "format_options": {
    "includeToc": true,
    "maxLength": 50000
  }
}
  • query: Enfermedad o condición médica a buscar (obligatorio)
  • format_options: Preferencias de formato opcionales
    • includeToc: Si se debe incluir una tabla de contenido (predeterminado: true)
    • maxLength: Longitud máxima del contenido devuelto en caracteres (predeterminado: 50000)

Ejemplo de salida

La herramienta devuelve contenido Markdown formateado con:

  • Información de título y fuente
  • Tabla de contenido (opcional)
  • Secciones estructuradas que incluyen etiología, epidemiología, fisiopatología, características clínicas, diagnóstico, tratamiento y pronóstico (cuando estén disponibles)

Desarrollo

Estructura del proyecto

statpearls-mcp/
├── src/                         # Source code
│   ├── index.ts                 # Main entry point and server setup
│   ├── test-html-parser.ts      # Test utility for HTML parser
│   ├── test-statpearls-parser.ts # Test utility for StatPearls parser
│   ├── testrun.ts               # Test runner utility
│   ├── tools/                   # Tool definitions and handlers
│   │   └── statpearls.ts        # StatPearls tool definition and handler
│   ├── services/                # Core functionality services
│   │   ├── search.ts            # Search functionality
│   │   ├── content.ts           # Content retrieval and processing
│   │   └── markdown.ts          # HTML to Markdown conversion
│   ├── types/                   # Type definitions
│   │   ├── index.ts             # Common type definitions
│   │   └── statpearls.ts        # StatPearls-specific type definitions
│   └── utils/                   # Utility functions
│       ├── html.ts              # HTML parsing utilities
│       ├── error.ts             # Error handling utilities
│       └── statpearls-parser.ts # StatPearls content parsing utilities
├── scripts/                     # Build and utility scripts
│   ├── build.ts                 # Build script for creating Node.js compatible bundle
│   ├── compile.ts               # Script for compiling executables
│   ├── release.ts               # Script for handling releases
│   └── version.ts               # Script for managing versioning
├── dist/                        # Build output directory (not in repository)
├── package.json                 # Project configuration and dependencies
├── tsconfig.json                # TypeScript configuration
├── bun.lock                     # Bun dependency lock file
├── README.md                    # Main project documentation
└── RELEASE-PROCESS.md           # Documentation for release process

Compilación y publicación

Compilación

El proceso de compilación crea un único archivo JavaScript que se puede ejecutar con Node.js estándar:

# Production build
bun run build
# or
bun run build:prod

# Development build
bun run build:dev

Esto crea un archivo empaquetado en dist/index.js que incluye todas las dependencias.

Compilación de ejecutables

Puedes compilar ejecutables específicos de cada plataforma usando la función de compilación de Bun:

# Compile for all platforms
bun run compile:all

# Compile for specific platforms
bun run compile:linux
bun run compile:windows
bun run compile:mac

Esto crea archivos ejecutables en el directorio dist:

  • statpearls-mcp (ejecutable predeterminado)
  • statpearls-mcp-linux-x64 (Linux)
  • statpearls-mcp-windows-x64.exe (Windows)
  • statpearls-mcp-darwin-x64 (macOS)

Publicación

El proceso de publicación maneja el versionado, la compilación, la generación de ejecutables y las operaciones de Git:

# Release a patch version (bug fixes)
bun run release:patch

# Release a minor version (new features, backward compatible)
bun run release:minor

# Release a major version (breaking changes)
bun run release:major

Este proceso:

  1. Actualiza la versión en package.json
  2. Compila el archivo de distribución
  3. Compila ejecutables para todas las plataformas
  4. Crea un commit de Git con el número de versión
  5. Crea una etiqueta de Git para la versión
  6. Envía el commit y la etiqueta a GitHub

Versionado

El proyecto sigue el versionado semántico. Puedes verificar la versión actual con:

bun run version

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.