Twitter MCP Server

Сервер для интеграции Twitter с AI-агентами через протокол MCP (Model Context Protocol). Предоставляет единый интерфейс для чтения, публикации и управления твитами, профилями и лентами.

Возможности

Чтение

• Получение твитов пользователя (до 50 за запрос) с медиа.
• Просмотр профиля: имя, описание, статистика.
• Поиск твитов по хештегам или ключевым словам с фильтром «последние/популярные».

Взаимодействие

• Лайк/анлайк, ретвит/отмена ретвита.
• Публикация твитов с текстом, медиа (JPEG, PNG, GIF, MP4), ответами и цитированием.
• Создание тредов.

Продвинутые функции

• Получение подписчиков и подписок.
• Тренды (актуальные темы).
• Ленты: домашняя, подписки, пользовательская.
• Твиты из списков.
• Подписка/отписка на пользователей.

Установка

1. Клонируйте репозиторий и установите зависимости:

   npm install
   

2. Соберите сервер:

   npm run build
   

3. Настройте переменные окружения (создайте .env или экспортируйте):

   TWITTER_USERNAME=ваш_логин
   TWITTER_PASSWORD=ваш_пароль
   TWITTER_EMAIL=ваш_email
   # Опционально: API-ключи для расширенной аутентификации
   TWITTER_API_KEY=...
   TWITTER_API_SECRET_KEY=...
   TWITTER_ACCESS_TOKEN=...
   TWITTER_ACCESS_TOKEN_SECRET=...
   

4. Добавьте конфигурацию в MCP-клиент (например, для Claude Desktop):
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "twitter-mcp-server": {
         "command": "/путь/к/twitter-mcp-server/build/index.js"
       }
     }
   }
   

Использование

После подключения к MCP-клиенту доступны следующие инструменты:

Чтение

• get_tweets — последние твиты пользователя.
• get_profile — информация о профиле.
• search_tweets — поиск по хештегу или ключевому слову.

Взаимодействие

• like_tweet — лайк/анлайк.
• retweet — ретвит/отмена.
• post_tweet — публикация твита (текст, медиа, ответ, цитата).
• create_thread — создание треда.

Ленты и тренды

• get_timeline — твиты из выбранной ленты (home, following, user).
• get_list_tweets — твиты из списка.
• get_trends — текущие тренды.

Управление пользователями

• get_user_relationships — подписчики или подписки.
• follow_user — подписка/отписка.

Разработка и отладка

• Автоматическая пересборка при изменениях: npm run watch.
• Отладка через MCP Inspector: npm run inspector — откроет URL в браузере.

Обработка ошибок

Сервер проверяет входные параметры, защищает от превышения лимитов и возвращает понятные сообщения об ошибках. Все ответы имеют единый формат:

{
  "content": [{
    "type": "text",
    "text": "JSON-строка с результатом или ошибкой"
  }]
}

Лицензия

MIT.