jorgen-k/reddit-mcp

O que reddit-mcp faz?

Servidor MCP local que permite ao Claude ler o Reddit por meio de seus feeds RSS públicos — sem necessidade de conta, aplicativo ou chave de API.

Visão Geral

Este servidor MCP (Model Context Protocol) atua como uma ponte entre assistentes de IA e o Reddit, utilizando feeds RSS públicos para acessar conteúdos como postagens, comentários e tendências. Ele elimina a necessidade de autenticação, tornando o processo rápido e acessível.

Recursos

• Acesso sem autenticação: Não requer conta, aplicativo registrado ou chave de API.
• Leitura de feeds RSS: Obtém dados de subreddits específicos ou do feed principal.
• Suporte a múltiplos subreddits: Permite especificar subreddits para consultas direcionadas.
• Integração com MCP: Compatível com Claude Desktop e outros clientes MCP.

Como Funciona

1. O assistente de IA envia uma requisição ao servidor MCP.
2. O servidor acessa os feeds RSS públicos do Reddit com base nos parâmetros fornecidos.
3. Os dados são convertidos em formato estruturado (ex.: JSON) e retornados ao assistente.
4. O assistente pode então processar, resumir ou responder com base nas informações obtidas.

Instalação

Pré-requisitos

• Node.js instalado (versão 16 ou superior).
• Um cliente MCP configurado (ex.: Claude Desktop).

Passos

# Clone o repositório
git clone https://github.com/jorgen-k/reddit-mcp.git

# Entre no diretório
cd reddit-mcp

# Instale as dependências
npm install

# Inicie o servidor
npm start

Configuração

Configure o servidor no cliente MCP adicionando as seguintes entradas ao arquivo de configuração do MCP:

{
  "mcpServers": {
    "reddit": {
      "command": "node",
      "args": ["caminho/para/reddit-mcp/index.js"],
      "env": {}
    }
  }
}

Uso

Após configurar, você pode enviar comandos ao servidor MCP a partir do assistente de IA. Exemplos de comandos:

• fetch_reddit_posts - Obter postagens de um subreddit (ex.: /r/artificial).
• fetch_reddit_comments - Obter comentários de uma postagem específica.
• search_reddit - Pesquisar termos no Reddit.

Exemplo de Requisição

{
  "command": "fetch_reddit_posts",
  "parameters": {
    "subreddit": "artificial",
    "limit": 10
  }
}

Limitações

• Apenas leitura: não é possível postar, votar ou comentar.
• Depende da disponibilidade dos feeds RSS do Reddit (podem sofrer alterações).
• Acesso limitado a conteúdo público.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests no repositório oficial.

Licença

Este projeto está licenciado sob a MIT License.