StatPearls

Obtém informações médicas e sobre doenças revisadas por pares do StatPearls.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Servidor MCP StatPearls

smithery badge

Um servidor Model Context Protocol (MCP) que busca informações sobre doenças no StatPearls, uma fonte confiável de conteúdo médico revisado por pares.

Dê ao seu sistema de IA uma fonte confiável de conhecimento médico para sua próxima conversa.

Recursos

  • Pesquisa doenças e condições médicas no StatPearls
  • Recupera informações médicas abrangentes e confiáveis do StatPearls
  • Converte conteúdo HTML em Markdown bem formatado para ser compatível com IA
  • Integra-se com modelos de IA por meio do Model Context Protocol

Image

Se você ainda não tem um cliente Model Context Protocol (MCP):

Se você é um usuário casual, pode usar o Claude Desktop para começar a usar servidores MCP. É um aplicativo de desktop gratuito e de código aberto que permite executar servidores MCP localmente e conectar-se a eles.

Se você é um usuário avançado/desenvolvedor, recomendo usar o VSCode com a extensão RooCode, que permite conectar servidores MCP ao seu ambiente de desenvolvimento para infinitas possibilidades!

Instalação

Depois de ter um cliente de IA compatível com MCP, você pode executar este servidor localmente.

A maneira mais fácil de começar é baixar o executável/binário apropriado para o seu sistema operacional na página de versões. Isso fornecerá um executável autônomo que você pode executar sem qualquer configuração adicional.

Coloque este executável em um diretório de sua escolha. Em seguida, basta adicionar o seguinte ao seu arquivo 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"
    },
    ...
  }
}

Instalando via Smithery

Para instalar o statpearls-mcp para Claude Desktop automaticamente via Smithery:

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

Para Desenvolvedores:

Você também pode executar o servidor a partir do código-fonte. Isso requer que o Bun esteja instalado no seu sistema.

  1. Clone o repositório
  2. Instale as dependências (bun install)
  3. Compile o servidor (bun run build)
  4. Agora você pode adicionar o servidor ao seu arquivo mcp_settings.json:
{
  "mcpServers": {
    ...
    "statpearls": {
      "command": "node",
      "args": [
        "{path_to_proj_here}/dist/index.js"
      ]
    },
    ...
  }
}

Definição da Ferramenta

O servidor fornece uma única ferramenta:

  • statpearls_disease_info: Busca informações médicas abrangentes e confiáveis sobre doenças no StatPearls.

Esquema de Entrada

{
  "query": "diabetes",
  "format_options": {
    "includeToc": true,
    "maxLength": 50000
  }
}
  • query: Doença ou condição médica para pesquisar (obrigatório)
  • format_options: Preferências opcionais de formatação
    • includeToc: Se deve incluir um sumário (padrão: true)
    • maxLength: Comprimento máximo do conteúdo retornado em caracteres (padrão: 50000)

Exemplo de Saída

A ferramenta retorna conteúdo Markdown formatado com:

  • Informações de título e fonte
  • Sumário (opcional)
  • Seções estruturadas incluindo etiologia, epidemiologia, fisiopatologia, características clínicas, diagnóstico, tratamento e prognóstico (quando disponíveis)

Desenvolvimento

Estrutura do Projeto

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

Compilação e Lançamento

Compilação

O processo de compilação cria um único arquivo JavaScript que pode ser executado com Node.js padrão:

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

# Development build
bun run build:dev

Isso cria um arquivo empacotado em dist/index.js que inclui todas as dependências.

Compilando Executáveis

Você pode compilar executáveis específicos para cada plataforma usando o recurso de compilação do 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

Isso cria arquivos executáveis no diretório dist:

  • statpearls-mcp (executável padrão)
  • statpearls-mcp-linux-x64 (Linux)
  • statpearls-mcp-windows-x64.exe (Windows)
  • statpearls-mcp-darwin-x64 (macOS)

Lançamento

O processo de lançamento lida com versionamento, compilação, geração de executáveis e operações 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 processo:

  1. Atualiza a versão no package.json
  2. Compila o arquivo de distribuição
  3. Compila executáveis para todas as plataformas
  4. Cria um commit Git com o número da versão
  5. Cria uma tag Git para a versão
  6. Envia o commit e a tag para o GitHub

Versionamento

O projeto segue versionamento semântico. Você pode verificar a versão atual com:

bun run version

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.