MCP Twitter Server

Implementation of the Twitter MCP service, providing API integration functions such as tweet posting, searching, and user information retrieval.

Social media Developer tools #Twitter Integration #Tweet Management #User Analysis #Social Media Tool .TypeScript

rating : 2.5 points

downloads : 6.4K

update time : 2025-04-29

Open Site

What is the Twitter MCP Server?

The Twitter MCP Server is a tool based on the Model Context Protocol (MCP) for interacting with the Twitter API. It allows users to easily publish, manage, analyze, and interact with content and users on the Twitter platform.

How to use the Twitter MCP Server?

By installing and configuring the server, you can start using various API features to manage your Twitter account. Just set up the environment variables and start the service in a few steps.

Applicable Scenarios

Suitable for enterprises, marketing teams, and individual creators who need to automate the management of social media accounts. It can be used for daily operations, data analysis, and brand promotion.

Main Features

Post a New Tweet

Post a new tweet directly from the server side to your account.

Search Tweets

Search for relevant tweets based on keywords or other conditions.

Get User Information

Query the detailed profile of a specific user.

Create a List

Create a new Twitter list in your account.

Advantages

Supports a variety of Twitter API operations with comprehensive functions.

Easy to install and configure, suitable for rapid deployment.

Powerful error handling mechanism to ensure stable operation.

Limitations

Some advanced features may require additional authorization.

Depends on Twitter API limitations, such as request frequency limits.

How to Use

Clone the Repository

Use Git to clone the source code of this project.

Install Dependencies

Install all necessary NPM packages.

Configure Environment Variables

Fill in the necessary Twitter API credentials.

Build the Project

Compile the server code.

Start the Server

Run the server to start the service.

Usage Examples

Post a Tweet

Send a test tweet to your account.

Create a List

Create a new list named 'Friends' in your account.

Frequently Asked Questions

How to update my Twitter API keys?

Why did my request fail?

Related Resources

GitHub Repository

Get the latest version and contribute code.

Twitter Developer Documentation

Understand the full functionality of the Twitter API.

🚀 Twitter MCP Server Status Report

This project provides a set of tools for interacting with the Twitter API, reporting the status of each tool, and guiding users through installation and setup.

🚀 Quick Start

📦 Installation

Build: Use the npm run build command to build the project.
Start: Use the npm start command to start the service.
Development Mode: Use the npm run dev command to start the development server with hot reloading.

⚙️ Environment Variables

All tools require the following environment variables:

TWITTER_API_KEY: The API key for the Twitter API.
TWITTER_API_SECRET_KEY: The secret key for the Twitter API.
TWITTER_ACCESS_TOKEN: The access token for the Twitter API.
TWITTER_ACCESS_TOKEN_SECRET: The access token secret for the Twitter API.

✨ Features

💻 Usage Examples

The following are the available tools and their usage information:

1. Post a Tweet (`postTweet`)

Status: Working properly.
Response: Returns the tweet ID.
Latest Test Result: Successful.

2. Get Tweet Information (`getTweetById`)

Status: Working properly.
Response: Returns the complete tweet data.
Latest Test Result: Successful.

3. Like and Unlike a Tweet (`likeTweet`, `unlikeTweet`)

Status: Working properly.
Response: Returns an operation confirmation message.
Latest Test Result: Successful.

4. Retweet and Undo Retweet (`retweet`, `undoRetweet`)

Status: Working properly.
Response: Returns an operation confirmation message.
Latest Test Result: Successful.

5. Reply to a Tweet (`replyToTweet`)

Status: Working properly.
Response: Returns the ID of the reply tweet.
Latest Test Result: Successful.

6. Get User Profile (`getUserInfo`)

Status: Working properly.
Response: Returns the complete user profile information.
Latest Test Result: Successful.

7. Follow and Unfollow a User (`followUser`, `unfollowUser`)

Status: Working properly.
Response: Returns an operation confirmation message.
Latest Test Result: Successful.

8. Create a List (`createList`)

Status: Working properly.
Response: Returns a confirmation message for creating the list.
Latest Test Result: Successful.

9. Get User Lists (`getUserLists`)

Status: Working properly.
Response: Returns the lists owned and participated in by the user.
Latest Test Result: Successful.

⚠️ Problematic Tools

Get User Timeline (getUserTimeline) [The description of the problem and related information for this tool are incomplete in the original text. Please provide more details if needed.]