Twitter MCP Server

Servidor MCP do Twitter

Um servidor MCP (Model Context Protocol) para o Claude contar com precisão os caracteres de posts do Twitter/X e otimizar posts.

Recursos

• Contagem precisa de caracteres: Calcula a contagem de caracteres com base no método oficial de contagem do Twitter/X
• Validação de posts: Verifica limites de caracteres e outras restrições
• Otimização de posts: Sugestões para otimizar posts muito longos
• Extração de entidades: Extrai e analisa URLs, menções e hashtags

Instalação

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

# Install dependencies
npm install

# Build
npm run build

Configuração para o Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do 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

As seguintes ferramentas estarão disponíveis no 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"

Desenvolvimento

# Start in development mode
npm run dev

# Build
npm run build

# Start in production
npm start

Detalhes da API

count_tweet_characters

• Entrada: text (string) - Texto para contar
• Saída: Informações detalhadas incluindo contagem de caracteres, caracteres restantes, validade

validate_tweet

• Entrada: text (string) - Texto para validar
• Saída: Validade, problemas, informações de entidades

optimize_tweet

• Entrada:
  • text (string) - Texto para otimizar
  • maxLength (número, opcional) - Contagem máxima de caracteres (padrão: 280)
• Saída: Texto otimizado e sugestões

extract_entities

• Entrada: text (string) - Texto do qual extrair entidades
• Saída: Listas de URLs, menções e hashtags

Pilha de tecnologia

• TypeScript: Segurança de tipos e melhor experiência de desenvolvimento
• @modelcontextprotocol/sdk: Implementação do servidor MCP
• twitter-text: Biblioteca oficial de contagem de caracteres do Twitter

Licença

Licença MIT

Contribuindo

1. Faça um fork deste repositório
2. Crie um branch de funcionalidade (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
4. Envie para o branch (git push origin feature/amazing-feature)
5. Crie um Pull Request

Suporte

Se você tiver problemas ou perguntas, por favor, relate-os nas Issues do GitHub.