Twitter MCP Server

Servidor MCP de Twitter

Una implementación de servidor de protocolo de contexto de modelo para la integración de API de Twitter.

Configuración

1. Clonar el repositorio
2. Instalar dependencias: npm install
3. Copie .env.example a .env y complete sus credenciales de API de Twitter
4. Construya el proyecto: npm run build
5. Iniciar el servidor: npm start

Variables de entorno

Credenciales de API de Twitter requeridas en .env :

Herramientas disponibles

Operaciones de Tweet

• postTweet : Publicar un nuevo tweet
  { "text": "Your tweet text here" }
• postTweetWithMedia : Publica un tweet con un archivo multimedia adjunto
  { "text": "Your tweet text", "mediaPath": "path/to/media/file", "mediaType": "image/jpeg|image/png|image/gif|video/mp4", "altText": "Optional alt text for accessibility" }
• getTweetById : Obtener un tweet específico por ID
  { "tweetId": "tweet_id", "tweetFields": ["created_at", "public_metrics"] }
• replyToTweet : Responder a un tweet existente
  { "tweetId": "tweet_id", "text": "Your reply text" }
• deleteTweet : Eliminar un tweet
  { "tweetId": "tweet_id" }

Búsqueda y análisis

• searchTweets : Buscar tweets
  { "query": "search query", "maxResults": 10, "tweetFields": ["created_at", "public_metrics"] }
• getHashtagAnalytics : Obtén análisis de un hashtag
  { "hashtag": "hashtag", "startTime": "ISO-8601 date", "endTime": "ISO-8601 date" }

Operaciones de usuario

• getUserInfo : Obtener información del usuario
  { "username": "twitter_username", "fields": ["description", "public_metrics"] }
• getUserTimeline : Obtener los tweets del usuario
  { "username": "twitter_username", "maxResults": 10, "tweetFields": ["created_at", "public_metrics"] }
• getFollowers : Obtener los seguidores del usuario
  { "username": "twitter_username", "maxResults": 100, "userFields": ["description", "public_metrics"] }
• getFollowing : Obtener las cuentas que sigue un usuario
  { "username": "twitter_username", "maxResults": 100, "userFields": ["description", "public_metrics"] }

Compromiso

• likeTweet : Me gusta un tweet
  { "tweetId": "tweet_id" }
• unlikeTweet : A diferencia de un tweet
  { "tweetId": "tweet_id" }
• retweet : retuitear un tuit
  { "tweetId": "tweet_id" }
• undoRetweet : Deshacer un retuit
  { "tweetId": "tweet_id" }
• getRetweets : Obtenga los usuarios que retuitearon un tweet
  { "tweetId": "tweet_id", "maxResults": 100, "userFields": ["description", "public_metrics"] }
• getLikedTweets : Obtén tweets que le gustan a un usuario
  { "userId": "user_id", "maxResults": 100, "tweetFields": ["created_at", "public_metrics"] }

Gestión de listas

• createList : Crea una nueva lista
  { "name": "List name", "description": "List description", "isPrivate": false }
• addUserToList : Agregar un usuario a una lista
  { "listId": "list_id", "username": "twitter_username" }
• removeUserFromList : Eliminar un usuario de una lista
  { "listId": "list_id", "username": "twitter_username" }
• getListMembers : Obtener miembros de una lista
  { "listId": "list_id", "maxResults": 100, "userFields": ["description", "public_metrics"] }

Manejo de errores

Todas las herramientas devuelven respuestas de error estandarizadas:

• Parámetros faltantes: Missing required parameter: parameter_name
• Errores de API: Mensaje de error de la API de Twitter
• Errores no encontrados: Mensaje de "no encontrado" apropiado para el recurso

Formato de respuesta

Todas las respuestas exitosas siguen este formato:

Desarrollo

• Construir: npm run build
• Inicio: npm start
• Modo de vigilancia: npm run dev

Estado: Funciona perfectamente Respuesta: Devuelve el ID del tweet Última prueba: Éxito

Estado: Funciona perfectamente Respuesta: Devuelve datos completos del tweet Última prueba: Éxito

Estado: Funciona perfectamente Respuesta: Confirmación de acción Última prueba: Éxito

Estado: Funciona perfectamente Respuesta: Confirmación de acción Última prueba: Éxito

Estado: Funciona perfectamente Respuesta: Devuelve el ID del tweet de respuesta Última prueba: Éxito

Estado: Funcionando perfectamente Respuesta: Datos de perfil de usuario completos Última prueba: Éxito

Estado: Funciona perfectamente Respuesta: Confirmación de acción Última prueba: Éxito

Estado: Funcionando perfectamente Respuesta: Confirmación de creación de lista Última prueba: Éxito

Estado: Funciona perfectamente Respuesta: Devuelve las listas de miembros y de propiedad. Última prueba: Éxito.

Estado: Error 400 Error: Parámetros de solicitud no válidos Solución necesaria: Validación de parámetros

Estado: Error 400 Error: Parámetros de solicitud no válidos Solución necesaria: Formato de parámetros de consulta

Estado: Error 400 Error: Parámetros de solicitud no válidos Solución necesaria: Validación de parámetros

2. Manejo de errores: