X-MCP-Ctrl is a powerful tool that allows you to control your X (formerly Twitter) account through LLM (Large Language Model) agents using applications like Claude Desktop or Cursor. This implementation leverages the MCP server to enable seamless interaction with your X account via AI-driven commands.
Setting up the MCP server is straightforward and involves just a few steps:
Clone the Repository
Start by cloning the repository to your local machine.
Install and Build the Project
Navigate to the project directory and run the following commands:
shell
npm install
npm run build
Update Your Configuration
Paste the following JSON configuration into your Claude or Cursor setup:
json
{
"mcpServers": {
"x-mcp-ctrls": {
"command": "node",
"args": [
"PATH_TO_DOWNLOADED_FOLDER\\build\\index.js"
],
"env":{
"X_API_KEY": "YOUR_API_KEY",
"X_API_SECRET_KEY": "YOUR_API_KEY",
"X_BEARER_TOKEN": "YOUR_API_KEY",
"X_ACCESS_TOKEN": "YOUR_API_KEY2",
"X_ACCESS_TOKEN_SECRET": "YOUR_API_KEY",
"GEMINI_API_KEY": "YOUR_API_KEY" // ONLY IF YOU WANT IMG GENERATION
}
}
}
}
Restart Your Application
After configuring, restart your application. You can now instruct the AI agent to perform actions on your X account.
Once configured, you can interact with your X account using natural language commands through the AI agent. For example:
- Post tweets
- Like or retweet posts
- Manage followers
- Generate images (if Gemini API key is provided)
This project is designed to simplify the management of your X account by integrating it with LLM agents. It is particularly useful for users who want to automate social media tasks or interact with their accounts programmatically.
No releases or packages have been published for this project.