twitter-mcp-server

serima/twitter-mcp-server

3.3

If you are the rightful owner of twitter-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

An MCP server designed for accurate character counting and optimization of Twitter/X posts.

Tools

  1. count_tweet_characters

    Accurately counts the characters in a Twitter/X post.

  2. validate_tweet

    Validates if a Twitter/X post meets character and other constraints.

  3. optimize_tweet

    Optimizes a Twitter/X post to fit within character limits.

  4. extract_entities

    Extracts URLs, mentions, and hashtags from a Twitter/X post.

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

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

# Install dependencies
npm install

# Build
npm run build

Configuration for Claude Desktop

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

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

Usage

The following tools will be available in 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"

Development

# Start in development mode
npm run dev

# Build
npm run build

# Start in production
npm start

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.