Twitter MCP Server

An MCP (Model Context Protocol) server for Claude to accurately count Twitter/X post characters and optimize posts.

Features

• Accurate Character Counting: Calculate character count based on Twitter/X's official counting method

• Post Validation: Check character limits and other constraints

• Post Optimization: Suggestions for optimizing posts that are too long

• Entity Extraction: Extract and analyze URLs, mentions, and hashtags

Installation

Configuration for Claude Desktop

Add the following to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json):

Usage

The following tools will be available in Claude:

1. count_tweet_characters

2. validate_tweet

3. optimize_tweet

4. extract_entities

Development

API Details

count_tweet_characters

• Input: text (string) - Text to count

• Output: Detailed information including character count, remaining characters, validity

validate_tweet

• Input: text (string) - Text to validate

• Output: Validity, issues, entity information

optimize_tweet

• Input:

  • text (string) - Text to optimize

  • maxLength (number, optional) - Maximum character count (default: 280)

• Output: Optimized text and suggestions

extract_entities

• Input: text (string) - Text to extract entities from

• Output: Lists of URLs, mentions, and hashtags

Tech Stack

• TypeScript: Type safety and better development experience

• @modelcontextprotocol/sdk: MCP server implementation

• twitter-text: Official Twitter character counting library

License

MIT License

Contributing

1. Fork this repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Create a Pull Request

Support

If you have any issues or questions, please report them in GitHub Issues.