MCP-Server para gerar ideias de conteúdos

by marioluciofjr

3 stars
207 downloads
Not rated
GitHub

About

Repositório com um MCP-Server que gera ideias de posts para blog, YouTube ou redes sociais

Details

Author
marioluciofjr
GitHub stars
3
Downloads
207
Categories
Other

- Generates a content matrix with main theme, subtopics, and micro-topics.
- Built with FastMCP following official MCP guidelines.
- Reads an example file showing the output structure.
- Simple installation and configuration for Claude Desktop.
- Uses Python 3.10+ and the uv package manager.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP-Server para gerar ideias de conteúdos
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Python 3.10 or higher, the uv package, and Claude Desktop. Create a project folder with uv init, activate a virtual environment, add the dependency mcp[cli], and create a server.py file. Then configure the claude_desktop_config.json file with the provided JSON entry using uv run server.py. The tool appears in Claude Desktop under the name subtemas.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-server para gerar ideias de conte\u00fados": {
            "ideias_de_posts": {
                "command": "uv",
                "args": [
                    "--directory",
                    "C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_content",
                    "run",
                    "server.py"
                ]
            }
        }
    }
}

McpServers

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

MCP-Server para gerar ideias de conteúdos

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

Í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

<div>
&nbsp;&nbsp;&nbsp
&nbsp;&nbsp;&nbsp
&nbsp;&nbsp;&nbsp
&nbsp;&nbsp;&nbsp
&nbsp;&nbsp;&nbsp
&nbsp;&nbsp;&nbsp;
</div>

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
>
> Image

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
>
> Image
>
> 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


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® <div> <a href="https://www.linkedin.com/in/marioluciofjr" target="_blank"></a> <a href = "mailto:marioluciofjr@gmail.com" target="_blank"></a> <a href="https://prazocerto.me/contato" target="_blank"></a> </div>
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.