Servidor MCP - Twitter NoAuth

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona acceso a la API de Twitter sin necesidad de configurar credenciales ni tokens locales. Proporciona operaciones básicas de Twitter, como buscar tuits, obtener tuits de usuarios, publicar tuits y responder a tuits.

Vídeo de demostración

https://www.youtube.com/watch?v=LOxFqCTPedc

¿Por qué MCP Twitter NoAuth Server?

Ventajas críticas

Operación remota y sin cabeza : este servidor puede ejecutarse de manera completamente sin cabeza en entornos remotos sin navegador ni acceso a archivos locales.
Arquitectura desacoplada : cualquier cliente puede completar el flujo OAuth de forma independiente y luego pasar credenciales como contexto a este servidor MCP, creando una separación completa entre el almacenamiento de credenciales y la implementación del servidor.

Agradable pero no crítico.

Funcionalidad enfocada : proporciona operaciones básicas de Twitter, como buscar tweets, obtener tweets de usuarios, publicar tweets y responder a tweets.
Docker-Ready : diseñado teniendo en cuenta la contenedorización para una configuración con un solo clic, independiente del entorno y bien aislada.
Dependencias confiables : construida sobre la biblioteca de solicitudes de Python estándar para la integración de la API de Twitter.

Características

Buscar tweets usando la API de Twitter
Obtener tweets recientes de un usuario específico
Obtener respuestas recientes de un usuario específico
Publicar nuevos tweets
Responder a tweets existentes
Actualizar los tokens de acceso por separado
Manejo automático de tokens de actualización

Prerrequisitos

Python 3.10 o superior
Credenciales de la API de Twitter (ID de cliente, secreto de cliente, token de acceso y token de actualización)

Instalación

# Clone the repository
git clone https://github.com/yourusername/mcp-twitter-noauth.git
cd mcp-twitter-noauth

# Install dependencies
pip install -e .

Estibador

Construyendo la imagen de Docker

# Build the Docker image
docker build -t mcp-twitter-noauth .

Uso con Claude Desktop

Uso de Docker

Puede configurar Claude Desktop para usar la imagen de Docker agregando lo siguiente a su configuración de Claude:

{
  "mcpServers": {
    "twitter": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-twitter-noauth:latest"
      ]
    }
  }
}

Nota: Con esta configuración, deberá proporcionar sus credenciales de la API de Twitter en las llamadas a herramientas, como se muestra en la sección "Uso de las herramientas" . Las credenciales de Twitter no se pasan como variables de entorno para mantener la separación entre el almacenamiento de credenciales y la implementación del servidor.

Publicación multiplataforma

Para publicar la imagen de Docker en varias plataformas, puede usar el comando docker buildx . Siga estos pasos:

Cree una nueva instancia de constructor (si aún no lo ha hecho):
docker buildx create --use
Construya y envíe la imagen para múltiples plataformas :
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-twitter-noauth:latest --push .
Verifique que la imagen esté disponible para las plataformas especificadas :
docker buildx imagetools inspect buryhuang/mcp-twitter-noauth:latest

Uso

El servidor proporciona la funcionalidad de Twitter mediante herramientas MCP. La autenticación se simplifica gracias a una herramienta dedicada a la actualización de tokens.

Iniciando el servidor

mcp-server-twitter-noauth

Usando las herramientas

Al utilizar un cliente MCP como Claude, tienes dos formas principales de manejar la autenticación:

Actualización de tokens (primer paso o cuando expiran)

Si tiene tokens de acceso y actualización:

{
  "twitter_access_token": "your_access_token",
  "twitter_refresh_token": "your_refresh_token",
  "twitter_client_id": "your_client_id",
  "twitter_client_secret": "your_client_secret"
}

Si su token de acceso ha expirado, puede actualizarlo solo con el token de actualización:

{
  "twitter_refresh_token": "your_refresh_token",
  "twitter_client_id": "your_client_id",
  "twitter_client_secret": "your_client_secret"
}

Esto devolverá un nuevo token de acceso y su tiempo de expiración, que puede usar para llamadas posteriores.

Buscando tweets

Buscar tweets usando la API de Twitter:

{
  "twitter_access_token": "your_access_token",
  "query": "your search query",
  "max_results": 10
}

La respuesta incluye datos del tweet, incluido el texto, la hora de creación y la información del autor.

Obtener tweets de usuarios

Obtener tweets recientes de un usuario específico:

{
  "twitter_access_token": "your_access_token",
  "user_id": "twitter_user_id",
  "max_results": 10
}

Obtener respuestas de los usuarios

Obtener respuestas recientes de un usuario específico:

{
  "twitter_access_token": "your_access_token",
  "user_id": "twitter_user_id",
  "max_results": 10
}

Publicar un tweet

Publicar un nuevo tweet:

{
  "twitter_access_token": "your_access_token",
  "text": "This is a test tweet from the MCP Twitter server"
}

Respondiendo a un Tweet

Responder a un tweet existente:

{
  "twitter_access_token": "your_access_token",
  "tweet_id": "id_of_tweet_to_reply_to",
  "text": "This is a reply to the original tweet"
}

Flujo de trabajo de actualización de tokens

Comience llamando a la herramienta twitter_refresh_token con:
- Sus credenciales completas (token de acceso, token de actualización, ID de cliente y secreto de cliente), o
- Solo su token de actualización, ID de cliente y secreto de cliente si el token de acceso ha expirado
Utilice el nuevo token de acceso devuelto para llamadas API posteriores.
Si recibe una respuesta que indica la expiración del token, llame a la herramienta twitter_refresh_token nuevamente para obtener un nuevo token.

Este enfoque simplifica la mayoría de las llamadas API al no requerir credenciales de cliente para cada operación y, al mismo tiempo, permite la actualización del token cuando es necesario.

Obtención de credenciales de la API de Twitter

Para obtener las credenciales de API de Twitter necesarias, siga estos pasos:

Vaya al portal para desarrolladores de Twitter
Crear un nuevo proyecto y aplicación
Configurar la autenticación OAuth 2.0
Configurar los ajustes de OAuth para su aplicación
Generar ID de cliente y secreto de cliente
Complete el flujo OAuth para obtener acceso y tokens de actualización

Actualización de tokens

Este servidor implementa la actualización automática de tokens. Cuando su token de acceso caduque, el servidor utilizará el token de actualización, el ID y el secreto del cliente para obtener un nuevo token de acceso sin necesidad de intervención del usuario.

Nota de seguridad

Este servidor requiere acceso directo a tus credenciales de la API de Twitter. Mantén siempre tus tokens y credenciales seguros y nunca los compartas con terceros no confiables.

Licencia

Consulte el archivo LICENCIA para obtener más detalles.