Crazyrabbitltc MCP Twitter Server

🚀 Twitter MCP Server

A Model Context Protocol server implementation for Twitter API integration.

🚀 Quick Start

📦 Installation

1. Clone the repository.
2. Install dependencies: npm install
3. Copy .env.example to .env and fill in your Twitter API credentials.
4. Build the project: npm run build
5. Start the server: npm start

⚙️ Environment Variables

The required Twitter API credentials that need to be filled in .env:

X_API_KEY=your_api_key
X_API_SECRET=your_api_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret

💻 Usage Examples

🐦 Tweet Operations

• postTweet: Post a new tweet.

{
    "text": "Your tweet content"
}

• postTweetWithMedia: Tweet with media attachment.

{
    "text": "Your tweet content",
    "mediaPath": "Media file path",
    "mediaType": "image/jpeg|image/png|image/gif|video/mp4",
    "altText": "Optional descriptive text (for accessibility)"
}

• getTweetById: Get a tweet by ID.

{
    "id": "Tweet ID"
}

• deleteTweet: Delete a specified tweet.

{
    "id": "Tweet ID"
}

👤 User Operations

• getUserProfile: Get the current user's profile information.

{
    "userId": "Target user ID (optional, default is the current user)"
}

• updateUserProfile: Update the user's profile information.

{
    "name": "New user name",
    "username": "New user handle",
    "bio": "New bio",
    "location": "New location information",
    "url": "New website link"
}

👥 Follow and Unfollow

• followUser: Follow a specified user.

{
    "userId": "User ID to follow"
}

• unfollowUser: Unfollow a specified user.

{
    "userId": "User ID to unfollow"
}

🔍 Search and Analysis

• searchTweets: Search for tweets that meet the criteria.

{
    "query": "Search keyword or phrase",
    "maxResults": "Maximum number of results to return (optional, default is 10)"
}

• getTopicTrend: Get the trend data of a specified topic.

{
    "topic": "Topic name to query"
}

📋 List Management

• createList: Create a new list.

{
    "listName": "Name of the new list",
    "mode": "public|private"  // List access permission, optional public or private, default is public
}

• addToList: Add a user to a specified list.

{
    "listId": "Target list ID",
    "userId": "User ID to add"
}

• removeFromList: Remove a user from a specified list.

{
    "listId": "Target list ID",
    "userId": "User ID to remove"
}

• getListMembers: Get all member information of a specified list.

{
    "listId": "Target list ID",
    "maxResults": "Maximum number of results to return (optional, default is 10)"
}

❌ Error Handling

All tools return a unified standard error response:

• Missing parameter: Missing required parameter: parameter_name
• API error: Error information returned by the Twitter API.
• Resource not found: Corresponding "not found" message for specific resources.

📄 Response Format

All successful responses follow the following format:

{
    "content": [
        {
            "type": "text",
            "text": "Operation result information"
        }
    ]
}

🛠️ Development Guide

• Build: npm run build
• Start: npm start
• Debug mode: npm run dev