Reddit MCP

Reddit MCP

Um servidor MCP plug-and-play para navegar, pesquisar e ler o Reddit.

Demonstração

Aqui está um vídeo curto mostrando como usar isso no Claude Desktop:

https://github.com/user-attachments/assets/a2e9f2dd-a9ac-453f-acd9-1791380ebdad

Recursos

• Validação detalhada de parâmetros com pydantic
• Usa a biblioteca confiável PRAW internamente
• Proteção integrada contra limite de taxa graças ao PRAW

Ressalvas

• Suporta apenas recursos de leitura por enquanto. Se você quiser usar recursos de escrita, vote no problema ou envie um PR! 🙌
• As ferramentas usam tokens. Para usar isso com o Claude, você pode precisar ser um usuário Pro para fazer muitas chamadas de ferramentas. Usuários do plano gratuito devem ficar bem com uso mais leve de ferramentas. O uso de tokens é de sua responsabilidade.

Instalação

Pré-requisito: credenciais da API do Reddit

Crie um aplicativo de desenvolvedor na sua conta do Reddit, se ainda não tiver um. Isso fornecerá um client_id e um client_secret para usar nas etapas a seguir. Se você já os tiver, pode pular esta etapa.

Claude Desktop

Para instalar no Claude Desktop:

• Siga as instruções aqui até a seção "Abra o arquivo de configuração em qualquer editor de texto."
• Adicione o seguinte ao arquivo, dependendo do método de instalação preferido:

Usando uvx (recomendado)

"mcpServers": {
  "reddit": {
    "command": "uvx",
    "args": ["reddit-mcp"],
    "env": {
      "REDDIT_CLIENT_ID": "<client_id>",
      "REDDIT_CLIENT_SECRET": "<client_secret>"
    }
  }
}

Usando PIP

Primeiro, instale o pacote:

pip install reddit-mcp

Depois, adicione o seguinte ao arquivo de configuração:

"mcpServers": {
  "reddit": {
    "command": "python",
    "args": ["-m", "reddit_mcp"],
    "env": {
      "REDDIT_CLIENT_ID": "<client_id>",
      "REDDIT_CLIENT_SECRET": "<client_secret>"
    }
  }
}

Outros

Você pode usar este servidor com qualquer cliente MCP, incluindo frameworks de agentes (LangChain, LlamaIndex, AutoGen, etc.). Para um exemplo de integração com AutoGen, confira o exemplo.

Ferramentas

As ferramentas que o servidor exporá são:

Nome	Descrição
get_comment	Acessar um comentário
get_comments_by_submission	Acessar comentários de uma postagem
get_submission	Acessar uma postagem
get_subreddit	Acessar um subreddit pelo nome
search_posts	Pesquisar posts em um subreddit
search_subreddits	Pesquisar subreddits por nome ou descrição

Contribuindo

Contribuições são bem-vindas! Veja CONTRIBUTING.md para mais informações.

Agradecimentos

• PRAW por uma biblioteca incrivelmente confiável 💙