MCP ExplorerExplorer

Mcp X

@Lyonsupernovaon 9 months ago
5 MIT
FreeCommunity
AI Systems
Model Context Protocol Servers connect with X (twitter)

Overview

What is Mcp X

mcp-x is a Model Context Protocol Server designed to connect Claude with the X API, enabling interaction with Twitter’s functionalities.

Use cases

Use cases for mcp-x include automating tweet posting for businesses, integrating Twitter functionalities into chatbots, and developing analytics tools that require real-time interaction with Twitter data.

How to use

To use mcp-x, set up your X Developer account, obtain necessary API credentials, and configure the server by placing the credentials in the specified configuration file. Run the command to start the server.

Key features

Key features of mcp-x include the ability to post tweets, with plans for additional functionalities such as retrieving and deleting tweets.

Where to use

mcp-x can be used in social media applications, marketing tools, and any platform that requires integration with Twitter’s API for enhanced user interaction.

Content

mcp-x MCP server

MCP project to connect Claude with X API. Built on top of X API v2

Demo

video-demo

Supported Features

  • Post tweets

Configuration

Getting Started with X

  • Go to X Developer Platform and login with your X account
  • Start with Basic plan
  • Store the Access Token, Secret, Client ID, Client Secret and Bearer token
    Docs: x-api-start

Set up

  • On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "x": {
      "command": "uv",
      "args": [
        "--directory",
        "PROJECT_PATH/src/mcp_x",
        "run",
        "mcp-x"
      ],
      "env": {
        "X_API_KEY": "YOUR_API_KEY",
        "X_API_KEY_SECRET": "YOUR_API_KEY_SECRET",
        "X_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN",
        "X_ACCESS_TOKEN_SECRET": "YOUR_ACCESS_TOKEN_SECRET",
        "X_BEARER_TOKEN": "YOUR_BEARER_TOKEN",
        "LOGGING_PATH": "PROJECT_PATH/src/mcp_x/logs"
      }
    }
  }
}

TODO

  • Tests
  • Add Get tweets
  • Add Delete tweets

Deployment

(todo)

Building and Publishing

To prepare the package for distribution:

  1. Sync dependencies and update lockfile:
uv sync
  1. Build package distributions:
uv build

This will create source and wheel distributions in the dist/ directory.

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers