kukapay/twitter-username-changes-mcp

An MCP server that tracks the historical changes of Twitter usernames—frequent screen name changes in crypto projects can be a red flag for potential scam risks.
Features
- **Username Change History**: Query the historical usernames of a Twitter user by their current screen name (e.g., @OSINT_Ukraine or @Mormonger).
- **Prompt Support**: Includes a prompt template to guide users in formulating queries.
- **Lightweight Design**: Built with minimal dependencies (mcp and requests) for easy setup.
Installation
Prerequisites
- Python 3.10+
- pip or uv for dependency management
- Claude Desktop (optional, for MCP integration)
Setup
1. **Clone the Repository**:
2. **Install Dependencies**:
Usage
Running the Server
Start the server in development mode to test locally:
This launches the MCP Inspector, where you can:
- List available tools (query_username_changes).
- Test queries (e.g., screen_name: "OSINT_Ukraine").
- Debug prompts.
Integrating with Claude Desktop
1. **Configure MCP Server**:
Edit the Claude Desktop configuration file:
- **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
Add the server:
Replace /absolute/path/to/ with the full path to main.py.
2. **Install the Server**:
3. **Query in Claude Desktop**:
- Open Claude Desktop and look for the hammer icon (indicating MCP tools).
- Enter a query like:
- Expected output:
Example Queries
1. **Query @Mormonger**:
Tool input: screen_name: "Mormonger"
Output:
2. **Query Invalid Handle**:
Tool input: screen_name: "InvalidUser123"
Output:
License
This project is licensed under the MIT License. See LICENSE for details.