Twitter MCP Server

Twitter MCP Server

Uma integração poderosa do Twitter para agentes de IA que utiliza o padrão Model Context Protocol (MCP), fornecendo um conjunto abrangente de funcionalidades do Twitter através de uma interface limpa e consistente.

Visão Geral

Este servidor fornece acesso aos recursos do Twitter através de ferramentas MCP, permitindo integração perfeita com assistentes de IA e outros clientes compatíveis com MCP. Ele é construído sobre a biblioteca agent-twitter-client e fornece tratamento robusto de erros, limitação de taxa e formatação consistente de respostas.

Recursos

Leitura Básica

• Obter tweets de usuários com suporte a mídia
• Buscar perfis de usuários com informações detalhadas
• Pesquisar tweets por hashtags ou palavras-chave
• Filtrar resultados de pesquisa por mais recentes/principais
• Limitação de taxa (máximo de 50 tweets por solicitação)

Interações do Usuário

• Curtir/Descurtir tweets
• Retweetar/Desfazer retweet
• Publicar tweets com:
  • Conteúdo de texto
  • Anexos de mídia (imagens, vídeos)
  • Funcionalidade de resposta
  • Capacidade de citar tweets

Recursos Avançados

• Obter relacionamentos de usuários (seguidores/seguindo)
• Buscar tópicos em alta
• Acessar diferentes tipos de linha do tempo:
  • Linha do tempo inicial
  • Linha do tempo de seguindo
  • Linha do tempo do usuário
• Gerenciamento de listas (buscar tweets de listas)

Mídia e Interações Avançadas

• Manipulação de mídia:
  • Upload de imagens (JPEG, PNG, GIF)
  • Upload de vídeos (MP4)
  • Suporte a texto alternativo
• Criação de threads
• Seguir/Deixar de seguir usuários

Ferramentas

Ferramentas de Leitura

• get_tweets - Buscar tweets recentes de um usuário
• get_profile - Obter informações do perfil de um usuário
• search_tweets - Pesquisar tweets por hashtag ou palavra-chave

Ferramentas de Interação

• like_tweet - Curtir ou descurtir um tweet
• retweet - Retweetar ou desfazer retweet
• post_tweet - Publicar um novo tweet com mídia opcional
• create_thread - Criar uma thread no Twitter

Ferramentas de Linha do Tempo

• get_timeline - Obter tweets de diferentes tipos de linha do tempo
• get_list_tweets - Obter tweets de uma lista do Twitter
• get_trends - Obter tópicos em alta atuais

Ferramentas de Gerenciamento de Usuários

• get_user_relationships - Obter lista de seguidores ou seguindo
• follow_user - Seguir ou deixar de seguir um usuário

Instalação

1. Instale as dependências:

npm install

2. Compile o servidor:

npm run build

3. Configure as variáveis de ambiente:

# Required: Twitter Account Credentials (for user authentication)
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email

# Twitter API Authentication (Optional)
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

4. Adicione a configuração do servidor ao seu cliente MCP:

No MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

No Windows:

%APPDATA%/Claude/claude_desktop_config.json

Configuração:

{
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "/path/to/twitter-mcp-server/build/index.js"
    }
  }
}

Desenvolvimento

Para desenvolvimento com recompilação automática:

npm run watch

Depuração

Como os servidores MCP se comunicam via stdio, você pode usar o MCP Inspector para depuração:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.

Tratamento de Erros

O servidor implementa tratamento abrangente de erros:

• Validação de entrada para todos os parâmetros
• Proteção contra limitação de taxa
• Mensagens de erro detalhadas
• Propagação adequada de erros
• Registro para depuração

Formato de Resposta

Todas as ferramentas retornam respostas em um formato consistente:

{
  content: [{
    type: "text",
    text: string // JSON stringified response or error message
  }]
}

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes