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: