mcp_news

O mcp_news é um MCP-Server em Python que oferece uma ferramenta de busca de notícias na web integrada ao protocolo Model Context Protocol (MCP). A ferramenta principal é o tool search_news, que busca notícias quando fornecida uma senha válida. O servidor também expõe um prompt chamado acesso, que orienta o modelo de linguagem a construir consultas de pesquisa e usar a ferramenta de busca para retornar resumos formatados de notícias. Para usar, você interage com o MCP por meio de seu modelo ou cliente compatível, fornecendo a senha correta armazenada no arquivo .env e solicitando pesquisas sobre temas específicos. O objetivo é retornar um resumo estruturado (título, resumo, contexto adicional) para o tema desejado, simulando o trabalho de apuração jornalística.

Pré-requisitos:

• Python 3.10 ou superior
• Acesso ao Claude Desktop (ou cliente MCP compatível)
• O pacote uv instalado no ambiente Python

Instalação passo a passo:

1. Instale o Python (versão 3.10+):
   • Baixe de https://www.python.org/downloads/ e siga o instalador.
2. Instale o UV (gestor de ambientes/execução de microserviços):
   • Abra o terminal e execute: pip install uv
3. Crie ou obtenha o código do mcp_news em uma pasta local (ex.: C:/projetos/mcp_news).
4. Ative um ambiente virtual (opcional, recomendado):
   • python -m venv venv
   • source venv/bin/activate (Linux/macOS) ou venv\Scripts\activate (Windows)
5. Instale dependências do projeto (se houver requirements.txt):
   • pip install -r requirements.txt
6. Execute o servidor MCP via UV apontando para o script server.py dentro da pasta do projeto:
   • uv --directory path/to/mcp_news run server.py
7. Opcional: configure o Claude Desktop para reconhecer o MCP, adicionando a configuração no arquivo claude_desktop_config.json conforme descrito na documentação do projeto.

Observação: O readme sugere o uso do uv com diretório específico e o comando run server.py; ajuste o caminho de acordo com o local onde você gravou o mcp_news.

Dicas úteis:

• Estruture o arquivo .env na raiz do projeto com a senha necessária para a ferramenta search_news. O acesso à ferramenta é protegido por senha conforme descrito no README.
• Verifique se o arquivo server.py e o script de inicialização estão presentes na pasta do projeto; a configuração do MCP aponta para server.py.
• Se o comando uv não for encontrado, certifique-se de que o caminho do Python e o uv estão no PATH do sistema.
• Ao usar Claude Desktop, siga as instruções específicas do README para adicionar o prompt de acesso (acesso) e o prompt de pesquisa, garantindo que a senha seja repassada pela ferramenta com segurança.
• Em ambientes Windows, utilize caminhos com barras invertidas ou o formato de caminho compatível com uv conforme mostrado no README de instalação.