mcp_content

mcp_content

1

This project is a simple MCP-Server that assists in organizing content creation ideas by generating thematic structures. It uses FastMCP and is aligned with the Model Context Protocol, aiding in content diversity and organization.

MCP-Server para gerar ideias de conteúdos

Made with Python license - MIT site - prazocerto.me linkedin - @marioluciofjr

Índice

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

  1. Chamei a pasta que eu tinha acabado de criar
    cd “C:\Users\meu_usuario\OneDrive\area_de_trabalho\MCPs\mcp_content”
    
  2. 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.

  1. Voltando ao terminal, utilizei o comando abaixo para inicializar um novo projeto Python, criando arquivos de configuração e dependências automaticamente
    uv init
    
  2. Utilizei em seguida o comando abaixo para criar um ambiente virtual Python isolado para instalar dependências do projeto
    uv venv
    
  3. Para ativar o .venv, utilizei o comando abaixo
    .venv\Scripts\Activate.ps1
    
  4. Adicionei a dependência MCP, necessária para o projeto
    uv add mcp[cli]
    
  5. 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

Image

  1. 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.

  1. 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

Image

A ferramenta foi nomeada como subtemas.

Links úteis

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®