Drug Gene Interaction Database (DGIdb)

Interagindo com o Drug Gene Interaction Database (DGIdb) via Claude Desktop

Licença e Citação

Este projeto está disponível sob a Licença MIT com um Requisito de Citação Acadêmica. Isso significa que você pode usar, modificar e distribuir o código livremente, mas qualquer publicação acadêmica ou científica que utilize este software deve fornecer a devida atribuição.

Para uso acadêmico/científico:

Se você usar este software em um projeto de pesquisa que resulte em publicação, apresentação ou relatório, você deve citar este trabalho de acordo com o formato fornecido em CITATION.md.

Para uso comercial/não acadêmico:

O uso comercial e não acadêmico segue os termos padrão da Licença MIT, sem o requisito de citação.

Ao usar este software, você concorda com estes termos. Consulte LICENSE.md para o texto completo da licença.

Este guia ajuda cientistas e pesquisadores a usar o Drug Gene Interaction Database (DGIdb) por meio de um aplicativo chamado Claude Desktop. Esta configuração permite que você faça perguntas sobre interações entre medicamentos e genes em linguagem natural e obtenha resultados diretamente no Claude.

O que é isso?

• DGIdb: Um banco de dados abrangente contendo informações sobre como medicamentos interagem com genes. Ele reúne dados de muitas fontes diferentes.
• Servidor MCP: Um software que atua como uma ponte. Este servidor específico se conecta à API do DGIdb. "MCP" significa Model Context Protocol, uma forma de modelos de IA (como o do Claude) usarem ferramentas.
• Claude Desktop: Um aplicativo onde você pode interagir com um assistente de IA. Ao configurá-lo corretamente, o Claude pode usar este Servidor MCP para buscar dados do DGIdb para você.

Essencialmente, este servidor dá ao Claude a "ferramenta" necessária para consultar informações no DGIdb.

Como Usar Isso com o Claude Desktop

Se este Servidor MCP do DGIdb foi configurado e implantado (por exemplo, por um colega técnico), você pode conectar seu aplicativo Claude Desktop a ele. Isso permite que você faça perguntas ao Claude como:

• "Quais são as interações para o medicamento Imatinib?"
• "Encontre genes que interagem com Dovitinib."
• "Mostre-me atributos de medicamentos para Trametinib."

O Claude usará então este servidor para encontrar as respostas no DGIdb e apresentá-las a você.

Configuração para o Claude Desktop

Seu aplicativo Claude Desktop precisa ser informado sobre onde encontrar este servidor DGIdb. Isso geralmente é feito editando um arquivo de configuração do Claude Desktop.

Um usuário técnico ou administrador normalmente cuidaria da implantação do servidor e forneceria a você uma URL específica (endereço web). Por exemplo, o servidor pode estar disponível em um endereço como: https://dgidb-mcp-server.your-organization.workers.dev/mcp.

A configuração no Claude Desktop seria então algo assim. Você adicionaria a seção "dgidb" dentro da parte mcpServers do seu arquivo de configuração do Claude Desktop:

{
  "mcpServers": {
    // ... (other server configurations might be here) ...

    "dgidb": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://dgidb-mcp-server.quentincody.workers.dev/mcp" // <-- This URL needs to be the actual address of YOUR deployed DGIdb MCP server
      ]
    }

    // ... (other server configurations might be here) ...
  }
}

Importante:

• A URL https://dgidb-mcp-server.quentincody.workers.dev/mcp no exemplo acima é ilustrativa. Você precisará substituí-la pela URL real onde sua instância do servidor MCP do DGIdb está em execução.
• Após atualizar a configuração, geralmente é necessário reiniciar o Claude Desktop para que as alterações tenham efeito.

Uma vez configurado, a ferramenta DGIdb deve ficar disponível no Claude, permitindo que você consulte o banco de dados facilmente.

Para Usuários Técnicos: Implantando o Servidor

Se você é um usuário técnico e precisa implantar este servidor (por exemplo, no Cloudflare Workers):

1. Começando: Você pode implantar este servidor no Cloudflare Workers. Consulte o README original, mais técnico, para botões de implantação e instruções de linha de comando (geralmente envolvendo npm create cloudflare@latest).

2. Personalização: O código do servidor está em src/index.ts. Este arquivo define como o servidor se conecta ao DGIdb e quais "ferramentas" ele fornece aos clientes MCP.

3. Conectando a Outros Clientes (como o AI Playground): Uma vez implantado, você também pode se conectar ao seu servidor MCP a partir de outros clientes, como o Cloudflare AI Playground, fornecendo sua URL (por exemplo, https://your-dgidb-server-name.your-account.workers.dev/mcp).

Este Servidor MCP do DGIdb usa a API GraphQL publicamente disponível do DGIdb em https://dgidb.org/api/graphql.