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.