Twitter MCP Server

by taazkareem
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supported as a platform for the MCP server, with specific configuration paths provided for macOS users.

  • Used for package management and running server scripts, facilitating installation and development workflows.

  • The server uses TypeScript for its response format, providing strongly typed structure for communication between the client and server.

Servidor MCP de Twitter

Una poderosa integración de Twitter para agentes de IA que aprovecha el estándar Model Context Protocol (MCP) y proporciona un conjunto completo de funciones de Twitter a través de una interfaz limpia y consistente.

Descripción general

Este servidor proporciona acceso a las funciones de Twitter mediante herramientas MCP, lo que permite una integración fluida con asistentes de IA y otros clientes compatibles con MCP. Está basado en la biblioteca agent-twitter-client y ofrece un manejo robusto de errores, limitación de frecuencia y un formato de respuesta consistente.

Características

Lectura básica

  • Obtenga tweets de usuarios con soporte de medios
  • Obtener perfiles de usuario con información detallada
  • Buscar tweets por hashtags o palabras clave
  • Filtrar los resultados de búsqueda por más recientes/principales
  • Limitación de velocidad (máximo 50 tweets por solicitud)

Interacciones del usuario

  • Me gusta/No me gusta los tweets
  • Retuitear/Deshacer retuit
  • Publica tweets con:
    • Contenido del texto
    • Archivos multimedia adjuntos (imágenes, vídeos)
    • Funcionalidad de respuesta
    • Capacidad de citar tweets

Funciones avanzadas

  • Obtener relaciones de usuario (seguidores/seguidos)
  • Obtener temas de tendencia
  • Acceda a diferentes tipos de líneas de tiempo:
    • Cronología del hogar
    • Siguiendo la cronología
    • Cronología del usuario
  • Gestión de listas (obtener tweets de la lista)

Medios e interacciones avanzadas

  • Manejo de medios:
    • Carga de imágenes (JPEG, PNG, GIF)
    • Subida de vídeo (MP4)
    • Compatibilidad con texto alternativo
  • Creación de hilos
  • Seguir/Dejar de seguir a usuarios

Herramientas

Herramientas de lectura

  • get_tweets - Obtener tweets recientes de un usuario
  • get_profile - Obtener la información del perfil de un usuario
  • search_tweets - Busca tweets por hashtag o palabra clave

Herramientas de interacción

  • like_tweet - Me gusta o no me gusta un tweet
  • retweet - Retuitear o deshacer un retuit
  • post_tweet - Publica un nuevo tweet con contenido multimedia opcional
  • create_thread - Crea un hilo de Twitter

Herramientas de línea de tiempo

  • get_timeline - Obtener tweets de diferentes tipos de líneas de tiempo
  • get_list_tweets - Obtener tweets de una lista de Twitter
  • get_trends - Obtenga los temas de tendencia actuales

Herramientas de gestión de usuarios

  • get_user_relationships - Obtener seguidores o lista de seguidos
  • follow_user - Seguir o dejar de seguir a un usuario

Instalación

  1. Instalar dependencias:
npm install
  1. Construir el servidor:
npm run build
  1. Configurar variables de entorno:
# 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
  1. Agregue la configuración del servidor a su cliente MCP:

En MacOS:

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

En Windows:

%APPDATA%/Claude/claude_desktop_config.json

Configuración:

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

Desarrollo

Para desarrollo con reconstrucción automática:

npm run watch

Depuración

Dado que los servidores MCP se comunican a través de stdio, puede utilizar el Inspector MCP para depurar:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Manejo de errores

El servidor implementa un manejo integral de errores:

  • Validación de entrada para todos los parámetros
  • Protección de limitación de velocidad
  • Mensajes de error detallados
  • Propagación adecuada de errores
  • Registro para depuración

Formato de respuesta

Todas las herramientas devuelven respuestas en un formato consistente:

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

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles

-
security - not tested
F
license - not found
-
quality - not tested

Proporciona a los agentes de IA una funcionalidad integral de Twitter a través del estándar Model Context Protocol, lo que permite leer tweets, publicar contenido, administrar interacciones y acceder a datos de la línea de tiempo con un manejo sólido de errores.

  1. Overview
    1. Features
      1. Basic Reading
      2. User Interactions
      3. Advanced Features
      4. Media & Advanced Interactions
    2. Tools
      1. Reading Tools
      2. Interaction Tools
      3. Timeline Tools
      4. User Management Tools
    3. Installation
      1. Development
        1. Debugging
      2. Error Handling
        1. Response Format
          1. Contributing
            1. License
              ID: qep2xkblkw