Twitter MCP Server

Twitter MCP Server

Un servidor MCP (Model Context Protocol) para Claude que cuenta con precisión los caracteres de publicaciones de Twitter/X y optimiza publicaciones.

Características

• Conteo preciso de caracteres: Calcula el conteo de caracteres según el método oficial de conteo de Twitter/X
• Validación de publicaciones: Verifica límites de caracteres y otras restricciones
• Optimización de publicaciones: Sugerencias para optimizar publicaciones demasiado largas
• Extracción de entidades: Extrae y analiza URLs, menciones y hashtags

Instalación

# Clone the repository
git clone <your-repo-url>
cd twitter-mcp-server

# Install dependencies
npm install

# Build
npm run build

Configuración para Claude Desktop

Agrega lo siguiente a tu archivo de configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "node",
      "args": ["/path/to/twitter-mcp-server/dist/server.js"]
    }
  }
}

Uso

Las siguientes herramientas estarán disponibles en Claude:

1. count_tweet_characters

Please count the characters in this Twitter/X post accurately:
"Hello! It's a beautiful day today ☀️ #goodweather https://example.com"

2. validate_tweet

Please validate if this post is valid:
"(long post text)"

3. optimize_tweet

Please optimize this post:
"(post text to optimize)"

4. extract_entities

Please extract entities from this post:
"@user Hello! #hello please check out https://example.com"

Desarrollo

# Start in development mode
npm run dev

# Build
npm run build

# Start in production
npm start

Detalles de la API

count_tweet_characters

• Entrada: text (string) - Texto a contar
• Salida: Información detallada que incluye el conteo de caracteres, caracteres restantes y validez

validate_tweet

• Entrada: text (string) - Texto a validar
• Salida: Validez, problemas e información de entidades

optimize_tweet

• Entrada:
  • text (string) - Texto a optimizar
  • maxLength (number, opcional) - Número máximo de caracteres (predeterminado: 280)
• Salida: Texto optimizado y sugerencias

extract_entities

• Entrada: text (string) - Texto del cual extraer entidades
• Salida: Listas de URLs, menciones y hashtags

Stack Tecnológico

• TypeScript: Seguridad de tipos y mejor experiencia de desarrollo
• @modelcontextprotocol/sdk: Implementación del servidor MCP
• twitter-text: Librería oficial de conteo de caracteres de Twitter

Licencia

Licencia MIT

Contribuciones

1. Haz un fork de este repositorio
2. Crea una rama de características (git checkout -b feature/amazing-feature)
3. Haz commit de tus cambios (git commit -m 'Add some amazing feature')
4. Haz push a la rama (git push origin feature/amazing-feature)
5. Crea un Pull Request

Soporte

Si tienes algún problema o pregunta, repórtalo en GitHub Issues.