MCP-Server para gerar ideias de conteúdos

MCP-Server para gerar ideias de conteúdos

Índice

• Introdução
• Estrutura do projeto
• Tecnologias utilizadas
• Requisitos
• Como instalar no Claude Desktop
• Links úteis
• Contribuições
• Licença
• Contato

Introdução

Este projeto mcp_content cria uma ferramenta simples para ajudar na organização de ideias para posts e vídeos. Ele gera uma lista estruturada com um tema principal, cinco subtemas e três microtemas para cada subtema, facilitando a criação de conteúdos variados. Além disso, o programa lê um arquivo de exemplo que mostra essa estrutura na prática.

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 . É um MCP-Server simples que utiliza somente o pacote FastMCP, seguindo também as orientações do repositório oficial do Model Context Protol, da Anthropic.

Como referência para a ideia deste MCP-server, está este prompt que fiz: Matriz de Conteúdo

Tecnologias utilizadas

                       

Requisitos

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

Como instalar no Claude Desktop

Agora vou detalhar como foi o meu passo a passo no Windows 11, utilizando o terminal (atalho CTRL + SHIFT + ') no VSCode:

1. Instalei a versão mais atualizada do Python
2. Já no VSCode, eu utizei o terminal para verificiar a versão do python com o comando

   python --version
   

3. Depois eu instalei o uv com o comando

   pip install uv
   

4. Para conferir se estava tudo certo, eu utilizei o comando

   uv
   

5. Para criar a pasta do projeto, eu utilizei este comando

   mkdir “C:\Users\meu_usuario\OneDrive\area_de_trabalho\MCPs\mcp_content”
   

Important

Não necessariamente quer dizer que você utilizará o mesmo caminho, pode ser que você queira utilizar outro caminho, como este abaixo

  mkdir "C:\Users\seu_usuario\mcp_content"

Ou você pode simplesmente fazer o download do zip desse projeto para a sua máquina pelo caminho Code > Download ZIP aqui mesmo no GitHub

6. Chamei a pasta que eu tinha acabado de criar

   cd “C:\Users\meu_usuario\OneDrive\area_de_trabalho\MCPs\mcp_content”
   

7. Utilizei o comando abaixo para abrir outra janela do VSCode e continuar com os demais comandos direto na pasta

   code .
   

Important

Se não quiser criar a pasta via terminal, você pode criar uma nova pasta na sua área de trabalho ou outro local que se lembre facilmente, a fim de utilizar o atalho no VSCode CTRL + O Depois é só procurar a pasta que acabou de criar, clicar nela e abrir no VSCode. Ou somente importar a pasta completa desse repositório no seu VSCode.

8. Voltando ao terminal, utilizei o comando abaixo para inicializar um novo projeto Python, criando arquivos de configuração e dependências automaticamente

   uv init
   

9. Utilizei em seguida o comando abaixo para criar um ambiente virtual Python isolado para instalar dependências do projeto

   uv venv
   

10. Para ativar o .venv, utilizei o comando abaixo

    .venv\Scripts\Activate.ps1
    

11. Adicionei a dependência MCP, necessária para o projeto

    uv add mcp[cli]
    

12. Verifiquei se estava tudo ok, com o comando abaixo

    uv run mcp
    

Important

Se aparecer esta informação abaixo no seu terminal é porque está tudo certo

13. Para criar o arquivo server.py, eu utilizei esse comando

    uv init --script server.py
    

Tip

Como você pode já ter baixado a pasta desse repositório, então o arquivo server.pyjá estará lá no seu VSCode nessa altura do campeonato.

14. Instalei o json abaixo do MCP-Server diretamente no arquivo claude_desktop_config.json

    "ideias_de_posts": {
      "command": "uv",
      "args": [
        "--directory",
        "C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_content",
        "run",
        "server.py"
      ]
    }
    

Important

Se você já instalou o Claude Desktop corretamente, siga o caminho para acessar o arquivo claude_desktop_config.json no seu computador
14a. Com o Claude Desktop aberto, utilize o atalho CTRL + ,
14b. Clique na aba Desenvolvedor e depois em Editar configuração
14c. Procure o arquivo claude_desktop_config.json e edite no VSCode corretamente
14d. Salve o arquivo com CTRL + S
14e. Feche o Claude Desktop e abra novamente depois de alguns segundos
14f. Confira no ícone de configuração se a ferramenta do MCP "mcp_content" está instalada corretamente

A ferramenta foi nomeada como subtemas.

Links úteis

• Documentação oficial do Model Context Protocol - Você saberá todos os detalhes dessa inovação da Anthropic
• Site oficial da Anthropic - Para ficar por dentro das novidaddes e estudos dos modelos Claude
• Como baixar o Claude Desktop - Link direto para download
• Como instalar o VSCode- Link direto para download
• Documentação oficial do pacote uv - Você saberá todos os detalhes sobre o uv e como ele é importante no python
• venv — Criação de ambientes virtuais - Explicação completa de como funcionam os venvs
• Conjunto de ícones de modelos de IA/LLM - site muito bom para conseguir ícones do ecossistema de IA
• Devicon - site bem completo também com ícones gerais sobre tecnologia
• Não é difícil encontrar ideias de conteúdo. - post do Victor Wendt sobre o processo de geração de novas ideias que ele utiliza

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 para detalhes.

Contato

Mário Lúcio - Prazo Certo®