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.

Related MCP server: MCP Twitter

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

2. Construir el servidor:

npm run build

3. 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

4. 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