# 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

```bash
# 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`):

```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

```bash
# 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.