Servidor X MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración con X (Twitter) que proporciona herramientas para leer tu cronología e interactuar con los tuits. Diseñado para su uso con Claude Desktop.

Características

• Recibe tweets desde tu cronología de inicio

• Crear nuevos tweets

• Responder a tweets

• Manejo de límite de velocidad integrado para el nivel de API gratuito

• Implementación de TypeScript con seguridad de tipos completa

Related MCP server: X (Twitter) MCP Server - Enhanced Edition

Prerrequisitos

• Node.js (v16 o superior)

• Cuenta de desarrollador de X (Twitter) (gratuita)

• Aplicación de escritorio de Claude

Acceso a la API X

X (Twitter) ofrece un nivel gratuito para el acceso básico a la API:

Funciones del nivel gratuito

• Límites de publicaciones:

  • 500 publicaciones al mes a nivel de usuario

  • 500 publicaciones al mes a nivel de aplicación

• Límites de lectura:

  • 100 lecturas al mes

• Características:

  • Acceso a los puntos finales de publicación de la versión 2

  • Puntos finales de carga de medios

  • Acceso a la API de anuncios

  • Limitado a 1 ID de aplicación

  • Iniciar sesión con la funcionalidad X

• Límites de velocidad:

  • Acceso con velocidad limitada a todos los puntos finales

  • Los límites se restablecen periódicamente

Nota: Para necesidades de mayor volumen, hay niveles pagos disponibles:

• Nivel básico ($100/mes): 50,000 tweets/mes, puntos finales adicionales

• Nivel Pro ($5000/mes): Límites más altos y funciones empresariales

Puede acceder al nivel gratuito en: https://developer.x.com/en/portal/products/free

Instalación

1. Clonar el repositorio:

git clone [your-repo-url]
cd x-mcp-server

2. Instalar dependencias:

npm install

3. Construir el servidor:

npm run build

Configuración

Debes configurar tus credenciales de la API de X (Twitter). Sigue estos pasos:

1. Vaya al portal para desarrolladores de Twitter

   • Inicia sesión con tu cuenta X (Twitter)

   • Si no tienes una cuenta de desarrollador, se te pedirá que crees una

2. Accede al nivel gratuito:

   • Visita https://developer.x.com/en/portal/products/free

   • Haga clic en "Suscribirse" para el nivel de acceso gratuito

   • Completar el proceso de registro

3. Crear un nuevo proyecto:

   • Haga clic en el botón "Crear proyecto"

   • Introduzca un nombre de proyecto (por ejemplo, "Integración MCP")

   • Seleccione "Gratis" como su configuración

   • Elige tu caso de uso

   • Haga clic en "Siguiente"

4. Crea una nueva aplicación dentro de tu proyecto:

   • Haga clic en "Crear aplicación"

   • Introduzca un nombre para la aplicación

   • Haga clic en "Completar configuración"

5. Configurar los ajustes de la aplicación:

   • En el panel de control de tu aplicación, haz clic en "Configuración de la aplicación".

   • En "Configuración de autenticación de usuario":

     • Haga clic en "Configurar"

     • Habilitar OAuth 1.0a

     • Seleccione "Aplicación web" o "Aplicación nativa"

     • Ingrese cualquier URL para la devolución de llamada (por ejemplo, https://example.com/callback )

     • Ingrese cualquier URL del sitio web (por ejemplo, https://example.com )

     • Haga clic en "Guardar"

6. Establecer permisos de la aplicación:

   • En la configuración de la aplicación, busque "Permisos de la aplicación".

   • Cambiar a "Leer y escribir"

   • Haga clic en "Guardar"

7. Generar claves API y tokens:

   • Vaya a la pestaña "Claves y tokens"

   • En "Claves del consumidor":

     • Haga clic en "Ver claves" o "Regenerar"

     • Guarde su clave API y su secreto de clave API

   • En "Token de acceso y secreto":

     • Haga clic en "Generar"

     • Asegúrese de seleccionar tokens con permisos de "Lectura y escritura"

     • Guarde su token de acceso y su secreto de token de acceso

Importante:

• Mantenga sus claves y tokens seguros y nunca los comparta públicamente

• Necesitarás los cuatro valores:

  • Clave API (también llamada clave de consumidor)

  • Secreto de clave API (también llamado secreto del consumidor)

  • Token de acceso

  • Token de acceso secreto

• Recuerde los límites del nivel gratuito:

  • 500 publicaciones al mes a nivel de usuario

  • 500 publicaciones al mes a nivel de aplicación

  • 100 lecturas al mes

Configuración del escritorio de Claude

Para conectar el servidor X MCP con el escritorio Claude, debe configurarlo en la configuración de Claude. Siga estos pasos:

1. Abrir el Explorador de archivos

2. Navegue al directorio de configuración de Claude:

   • Presione Win + R

   • Escriba %APPDATA%/Claude y presione Enter

   • Si la carpeta Claude no existe, créela

3. Crea o edita claude_desktop_config.json :

   • Si el archivo no existe, crea un nuevo archivo llamado claude_desktop_config.json

   • Si existe, ábralo en un editor de texto (como el Bloc de notas)

4. Agregue la siguiente configuración, reemplazando los valores de marcador de posición con sus credenciales de API reales de la sección anterior:

{
  "mcpServers": {
    "x": {
      "command": "node",
      "args": ["%USERPROFILE%/Projects/MCP Basket/x-server/build/index.js"],
      "env": {
        "TWITTER_API_KEY": "paste-your-api-key-here",
        "TWITTER_API_SECRET": "paste-your-api-key-secret-here",
        "TWITTER_ACCESS_TOKEN": "paste-your-access-token-here",
        "TWITTER_ACCESS_SECRET": "paste-your-access-token-secret-here"
      }
    }
  }
}

5. Guarde el archivo y reinicie el escritorio de Claude

Nota: Asegúrese de:

• Reemplace los cuatro valores de credenciales con sus claves API y tokens reales

• Mantenga las comillas ("") alrededor de cada valor

• Mantenga el espaciado y formato exactos que se muestran arriba.

• Guarde el archivo con la extensión .json

Herramientas disponibles

cronograma de llegada a casa

Obtén los tweets más recientes desde tu cronología de inicio.

Parámetros:

• limit (opcional): Número de tweets a recuperar (predeterminado: 20, máximo: 100)

Ejemplo:

await use_mcp_tool({
  server_name: "x",
  tool_name: "get_home_timeline",
  arguments: { limit: 5 }
});

crear_tweet

Crear un nuevo tweet.

Parámetros:

• text (obligatorio): El contenido de texto del tweet (máximo 280 caracteres)

Ejemplo:

await use_mcp_tool({
  server_name: "x",
  tool_name: "create_tweet",
  arguments: { text: "Hello from MCP! 🤖" }
});

responder al tuit

Responder a un tweet.

Parámetros:

• tweet_id (obligatorio): El ID del tweet al que se responderá

• text (obligatorio): El contenido del texto de la respuesta (máximo 280 caracteres)

Ejemplo:

await use_mcp_tool({
  server_name: "x",
  tool_name: "reply_to_tweet",
  arguments: {
    tweet_id: "1234567890",
    text: "Great tweet! 👍"
  }
});

Desarrollo

• npm run build : compila el código TypeScript

• npm run dev : ejecuta TypeScript en modo de vigilancia

• npm start : Inicia el servidor MCP

Limitación de velocidad

El servidor incluye un manejo de límite de velocidad integrado para el nivel gratuito de X:

• Límites mensuales:

  • 500 publicaciones al mes a nivel de usuario

  • 500 publicaciones al mes a nivel de aplicación

  • 100 lecturas al mes

• Características:

  • Realiza un seguimiento del uso mensual

  • Proporciona un retroceso exponencial para errores de límite de velocidad

  • Borrar los mensajes de error cuando se alcanzan los límites

  • Reintento automático después de que expire la ventana de límite de velocidad

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción