UniProt MCP Server

Obtenha informações sobre proteínas do banco de dados UniProt.

Documentação

Servidor MCP UniProt

Um servidor MCP (Model Context Protocol) que permite que modelos de linguagem obtenham informações sobre proteínas do banco de dados UniProt. Este servidor pode ser integrado ao Claude Desktop e a outros aplicativos de IA compatíveis com MCP.

Recursos

  • Buscar no UniProt: Pesquise proteínas por nome, gene ou outros critérios
  • Obter Detalhes da Proteína: Recupere informações detalhadas sobre uma proteína
  • Obter Sequências de Proteínas: Busque sequências de aminoácidos
  • Obter Funções das Proteínas: Recupere anotações funcionais, incluindo termos GO
  • Obter Estruturas de Proteínas: Encontre estruturas PDB relacionadas

Instalação

  1. Clone este repositório:

    git clone https://github.com/yourusername/uniprot-mcp-server.git
    cd uniprot-mcp-server
    
  2. Crie um ambiente virtual (opcional, mas recomendado):

    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
    
  3. Instale as dependências:

    pip install -r requirements.txt
    

Configuração Local com Claude Desktop

  1. Torne o script do servidor executável:

    chmod +x server.py
    
  2. Configure o Claude Desktop para usar este servidor MCP:

    Para macOS/Linux:

    code ~/Library/Application\ Support/Claude/claude_desktop_config.json
    

    Para Windows:

    code $env:AppData\Claude\claude_desktop_config.json
    
  3. Adicione a seguinte configuração (atualize o caminho para corresponder ao local real do seu arquivo):

    {
      "mcpServers": {
        "uniprot": {
          "command": "python",
          "args": [
            "/ABSOLUTE/PATH/TO/uniprot-mcp-server/server.py"
          ]
        }
      }
    }
    
  4. Reinicie o Claude Desktop

Exemplos de Uso

Depois de configurado com o Claude Desktop, você pode fazer perguntas como:

  • "Encontre proteínas relacionadas à doença de Alzheimer"
  • "Obtenha a sequência da proteína P05067 (proteína precursora do amiloide-beta)"
  • "Quais são as funções da proteína TP53?"
  • "Existem estruturas 3D conhecidas para a proteína BRCA1?"

Desenvolvimento

Para executar o servidor diretamente para testes:

python server.py

Utilitários de Teste

Este projeto inclui dois utilitários de teste para verificar a funcionalidade:

1. Verificação de Saúde do Servidor

Verifica se o servidor MCP inicia corretamente sem erros:

python server_health_check.py

2. Teste da API UniProt

Testa a conectividade com a API UniProt e verifica se todas as chamadas de API funcionam conforme o esperado:

python test_server.py

Execute esses testes antes de usar o servidor para garantir que tudo esteja configurado corretamente.

Licença

MIT

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

  1. Faça um fork do repositório
  2. Crie sua branch de recurso (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request