Servidor MCP X (Twitter)

Este servidor MCP permite a los clientes interactuar con X (anteriormente Twitter), lo que habilita operaciones integrales de la plataforma, que incluyen publicar tweets, buscar contenido, administrar cuentas y organizar listas.

Inicio rápido

Cree una cuenta de desarrollador X y obtenga sus claves API desde el Portal para desarrolladores X
Establezca todas las claves API necesarias en las variables de entorno
Clonar este repositorio: git clone https://github.com/Dishant27/twitter-mcp.git
Instalar dependencias: npm install
Ejecutar el servidor:

Con variables de entorno:

TWITTER_API_KEY=your_api_key \
TWITTER_API_SECRET=your_api_secret \
TWITTER_ACCESS_TOKEN=your_access_token \
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret \
npm start

Usando un archivo .env :

# Create a .env file with your X API keys
echo "TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret" > .env

# Start the server
npm start

Úselo con un cliente MCP, como Claude.

Configuración de Claude

Para usar este servidor con Claude, deberá configurar MCP. A continuación, se muestra un ejemplo de cómo debería verse la estructura de configuración:

{
  "name": "x",
  "display_name": "X",
  "description": "X MCP allows Claude to interact with X (formerly Twitter)",
  "path": "path/to/twitter-mcp/dist/index.js",
  "startup": {
    "env": {
      "TWITTER_API_KEY": "your_api_key",
      "TWITTER_API_SECRET": "your_api_secret",
      "TWITTER_ACCESS_TOKEN": "your_access_token",
      "TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret"
    }
  },
  "transport": "stdio"
}

Guarde esta configuración en su directorio de configuración de Claude MCP, normalmente ubicado en:

Ventanas: %APPDATA%\AnthropicClaude\mcp-servers
macOS: ~/Library/Application Support/AnthropicClaude/mcp-servers
Linux: ~/.config/AnthropicClaude/mcp-servers

Características

Operaciones posteriores

Contenido de la publicación (hasta 280 caracteres)
Búsqueda de publicaciones por consulta con recuento de resultados personalizable

Gestión de cuentas

Obtener información del perfil de cualquier usuario o de la cuenta autenticada
Actualizar los detalles del perfil (nombre, biografía, ubicación, URL del sitio web)
Seguir y dejar de seguir a usuarios
Lista de seguidores de cualquier usuario o cuenta autenticada
Lista de cuentas que sigue un usuario

Gestión de listas

Crear nuevas listas (públicas o privadas)
Obtenga información sobre listas específicas
Recuperar todas las listas propiedad del usuario autenticado

Herramientas MCP disponibles

Nombre de la herramienta	Descripción
`post_tweet`	Publicar contenido nuevo en X
`search_tweets`	Buscar contenido en X
`get_profile`	Obtener información del perfil de un usuario o de la cuenta autenticada
`update_profile`	Actualizar el perfil del usuario autenticado
`follow_user`	Seguir a un usuario
`unfollow_user`	Dejar de seguir a un usuario
`list_followers`	Lista de seguidores de un usuario o de la cuenta autenticada
`list_following`	Enumere las cuentas que un usuario o la cuenta autenticada está siguiendo
`create_list`	Crear una nueva lista
`get_list_info`	Obtener información sobre una lista
`get_user_lists`	Obtener todas las listas propiedad del usuario autenticado

Requisitos

Node.js 18.x o superior
Cuenta de desarrollador X con claves API
Acceso API v1 y v2

Variables de entorno

Variable	Descripción
`TWITTER_API_KEY`	Su clave API
`TWITTER_API_SECRET`	Tu secreto de API
`TWITTER_ACCESS_TOKEN`	Su token de acceso
`TWITTER_ACCESS_TOKEN_SECRET`	Su token de acceso secreto

Estructura del repositorio

twitter-mcp/
├── .github/
│   └── workflows/
│       ├── publish.yml
│       └── release.yml
├── code/
│   ├── account_management.py  # Sample Python code for account management
│   ├── post_tweet.py          # Sample Python code for posting content
│   └── retrieve_tweets.py     # Sample Python code for retrieving content
├── src/
│   ├── index.ts        # Main entry point
│   ├── twitter-api.ts  # X API client
│   ├── formatter.ts    # Response formatter
│   └── types.ts        # Type definitions
├── .env.example
├── .gitignore
├── Dockerfile
├── LICENSE
├── package.json
├── README.md
└── tsconfig.json

Licencia

Instituto Tecnológico de Massachusetts (MIT)