# Mcp News

> Repositório com um MCP-Server que traz um resumo de notícias, mas só se tiver a senha correta da tool

- **Type:** MCP server
- **Install:** `agentstack add mcp-marioluciofjr-mcp-news`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [marioluciofjr](https://agentstack.voostack.com/s/marioluciofjr)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [marioluciofjr](https://github.com/marioluciofjr)
- **Source:** https://github.com/marioluciofjr/mcp_news

## Install

```sh
agentstack add mcp-marioluciofjr-mcp-news
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# mcp_news

[](https://python.org "Go to Python homepage")

## Índice

* [Introdução](#introdução)
* [Estrutura do projeto](#estrutura-do-projeto)
* [Tecnologias utilizadas](#tecnologias-utilizadas)
* [Requisitos](#requisitos)
* [Como instalar no Claude Desktop](#como-instalar-no-claude-desktop)
* [Links úteis](#links-úteis)
* [Contribuições](#contribuições)
* [Licença](#licença)
* [Contato](#contato)

## Introdução

Este projeto `mcp_news` oferece uma ferramenta para buscar e resumir notícias da web. Utilizando o protocolo MCP (Model Context Protocol), ele permite que um modelo de linguagem interaja com uma ferramenta de busca de notícias de forma segura, por meio de uma senha, e apresente os resultados de forma estruturada. A ideia é fornecer um resumo conciso e direto ao ponto sobre um determinado tema, simulando o trabalho de apuração jornalística.

## Estrutura do projeto

Este projeto leva em consideração as explicações do professor Sandeco Macedo, da UFG (Universidade Federal de Goiás), sobre MCPs por meio do livro [MCP e A2A para Leigos
](https://physia.com.br/mcp/). É um MCP-Server simples que utiliza somente o pacote FastMCP, seguindo também as orientações do repositório oficial do [Model Context Protol](https://github.com/modelcontextprotocol/python-sdk), da Anthropic.

Este MCP-Server tem as seguintes classes: 

* tool `search_news`:
    * Esta ferramenta é responsável por realizar a busca de notícias na web.
    * Argumentos:
        * `pesquisa` (str): O termo ou tema a ser pesquisado.
        * `senha` (str): Uma senha para autorizar o uso da ferramenta.
    * Funcionamento: Se a senha fornecida estiver correta (conforme definido em um arquivo `.env`), a ferramenta utiliza `WebSearchTool` (de `smolagents`) para buscar a notícia. Caso contrário, retorna uma mensagem de erro.
    * Retorno: O resultado da busca ou uma mensagem de erro.
* prompt `acesso`:
    * Este prompt é projetado para ser usado por um modelo de linguagem. Ele instrui o modelo a atuar como um jornalista experiente.
    * Argumentos (para o modelo preencher e depois usar na tool):
        * `senha` (str): A senha para acessar a `tool search_news`.
        * `tema` (str): O tema da pesquisa de notícias.
    * Funcionamento: O prompt guia o modelo a:
        1.  Verificar a senha.
        2.  Formular uma consulta de pesquisa combinando o `tema` com a palavra "news".
        3.  Chamar a `tool search_news` com a consulta e a senha.
        4.  Com base nos resultados da tool, criar um resumo da notícia em um formato específico (Título, parágrafo 1: Resumo, parágrafo 2: Contexto adicional).
    * Retorno: Uma string formatada contendo o resumo da notícia ou uma indicação de falha se a senha estiver incorreta.
 
Se quiser conversar sobre esse projeto, basta acessar a versão [TalkToGitHub](https://talktogithub.com/marioluciofjr/mcp_news)

Want to better understand this repository, but you don't speak Portuguese? Check out this complete tutorial: [`Codebase - mcp_news`](https://code2tutorial.com/tutorial/a67c8977-c7d2-49de-8374-c601a2893a00/index.md)

## Tecnologias utilizadas

  &nbsp;&nbsp;&nbsp
  &nbsp;&nbsp;&nbsp
  &nbsp;&nbsp;&nbsp
  &nbsp;&nbsp;&nbsp
  &nbsp;&nbsp;&nbsp
 

* MCP (Model Context Protocol);
* Python;
* Claude Desktop;
* VSCode;
* Powershell.

## Requisitos

* Python instalado (versão 3.10 ou superior);
* Pacote `uv` instalado;
* Claude Desktop instalado.

## Como instalar no Claude Desktop

Agora vou detalhar um passo a passo no Windows 11, utilizando o terminal (atalho `CTRL` + `J`) no VSCode: 

1. Instalei a [versão mais atualizada do Python](https://www.python.org/downloads/)
2. Já no VSCode, utilize o terminal para verificiar a versão do python com o comando
   ```powershell
   python --version
   ```
3. Depois instale o `uv` com o comando
   ```powershell
   pip install uv
   ```
4. Para conferir se estava tudo certo, utilize o comando
   ```powershell
   uv
   ```
5. Faça o download do zip desse projeto para a sua máquina pelo caminho `Code` > `Download ZIP` aqui mesmo no GitHub. Descompacte a pasta no diretório que preferir.

6. No VSCode use o caminho `CTRL` + `O` e escolha a pasta que acabou de descompactar

7. Voltando ao terminal, utilize o comando abaixo para inicializar um novo projeto Python, criando arquivos de configuração e dependências automaticamente
   ```powershell
   uv init
   ```
8. Adicione as dependências necessárias deste projeto
    ```powershell
    uv add mcp[cli] dotenv smolagents[toolkit]
    ```
9. Verifique se está tudo ok, com o comando abaixo
    ```powershell
    mcp
    ```

> [!IMPORTANT]
> Se aparecer esta informação abaixo no seu terminal é porque está tudo certo
> 
> 

10. Renomeie o arquivo `.env.example` clicando nele e usando o atalho F2 do teclado. Renomeie como `.env` somente.

11. Instale o json abaixo do MCP-Server diretamente no arquivo `claude_desktop_config.json`
    ```json
    "news": {
      "command": "uv",
      "args": [
        "--directory",
        "C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_news",
        "run",
        "server.py"
      ]
    }
    ```
> [!IMPORTANT]
> O meu diretório foi algo parecido com isso "C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_news", mas é óbvio que você deve colocar o seu caminho para a pasta `mcp_news`
> 

> [!IMPORTANT]
> Se você já instalou o Claude Desktop corretamente, siga o caminho para acessar o arquivo `claude_desktop_config.json` no seu computador\
> 11a. Com o Claude Desktop aberto, utilize o atalho `CTRL` + `,`\
> 11b. Clique na aba `Desenvolvedor` e depois em `Editar configuração`\
> 11c. Procure o arquivo `claude_desktop_config.json` e edite no VSCode corretamente\
> 11d. Salve o arquivo com `CTRL` + `S`\
> 11e. Feche o Claude Desktop e abra novamente depois de alguns segundos\
> 11f. Confira no ícone de configuração se a ferramenta do MCP `mcp_news` está instalada corretamente
>
> 
>
> A ferramenta foi nomeada como `search_news`.
>
> 11g. Para utilizar, você deve clicar no ícone de '+' e, na opção `Adicionar do news`, clicar no no prompt chamado `acesso`.
> Ao clicar no prompt `acesso`, aparecerá um formulário. Basta preencher e clicar no botão `Adicionar prompt` e executar no Claude Desktop.

## Links úteis

* [Documentação oficial do Model Context Protocol](https://modelcontextprotocol.io/introduction) - Você saberá todos os detalhes dessa inovação da Anthropic
* [Site oficial da Anthropic](https://www.anthropic.com/) - Para ficar por dentro das novidaddes e estudos dos modelos Claude
* [Como baixar o Claude Desktop](https://claude.ai/download) - Link direto para download
* [Como instalar o VSCode](https://code.visualstudio.com/download)- Link direto para download
* [Documentação oficial do pacote uv](https://docs.astral.sh/uv/) - Você saberá todos os detalhes sobre o `uv` e como ele é importante no python
* [venv — Criação de ambientes virtuais](https://docs.python.org/pt-br/3/library/venv.html) - Explicação completa de como funcionam os venvs
* [Conjunto de ícones de modelos de IA/LLM](https://lobehub.com/pt-BR/icons) - site muito bom para conseguir ícones do ecossistema de IA
* [Devicon](https://devicon.dev/) - site bem completo também com ícones gerais sobre tecnologia
* [Smolagents](https://github.com/huggingface/smolagents) - documenttação oficial da biblioteca smolagents

## Contribuições

Contribuições são bem-vindas! Se você tem ideias para melhorar este projeto, sinta-se à vontade para fazer um fork do repositório.

## Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo [LICENSE](https://github.com/marioluciofjr/mcp_news/blob/main/LICENSE) para detalhes.

## Contato
    
Mário Lúcio - Prazo Certo®

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [marioluciofjr](https://github.com/marioluciofjr)
- **Source:** [marioluciofjr/mcp_news](https://github.com/marioluciofjr/mcp_news)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-marioluciofjr-mcp-news
- Seller: https://agentstack.voostack.com/s/marioluciofjr
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
