twitter-username-changes-mcp

🚀 Twitter用户名变化MCP服务器

这是一个用于跟踪Twitter用户名历史变化的MCP服务器。在加密项目中，频繁更改屏幕名称可能是潜在诈骗风险的警示信号，该服务器可帮助您及时察觉此类风险。

✨ 主要特性

• 用户名变更历史：可通过当前的屏幕名称（例如@OSINT_Ukraine或@Mormonger）查询用户的历史用户名。
• 提示支持：包含提示模板，能帮助用户构建查询问题。
• 轻量级设计：仅使用最少的依赖项（mcp和requests）实现，便于快速部署。

📦 安装指南

先决条件

• Python 3.10+版本
• pip或uv用于依赖管理
• Claude Desktop（可选，用于MCP集成）

设置

1. 克隆仓库：

   git clone https://github.com/kukapay/twitter-username-changes-mcp.git
   cd twitter-username-changes-mcp
   

2. 安装依赖项：

   pip install mcp[cli] requests
   

💻 使用示例

运行服务器

以开发模式启动服务器进行本地测试：

mcp dev main.py

启动MCP检测器后，您可以：

• 列出所有可用工具（query_username_changes）。
• 测试查询（例如screen_name: "OSINT_Ukraine"）。
• 调试提示内容。

与Claude Desktop集成

1. 配置MCP服务器： 编辑Claude Desktop配置文件：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json 添加以下内容到mcpServers部分：

   {
     "mcpServers": {
       "twitter-username-changes": {
         "command": "python",
         "args": [
           "/absolute/path/to/twitter-username-changes-mcp/main.py"
         ]
       }
     }
   }
   

   请将/absolute/path/to/替换为main.py的实际路径。
2. 安装服务器：

   mcp install main.py --name "TwitterUsernameChanges"
   

3. 在Claude Desktop中查询：
   • 打开Claude Desktop并查找锤子图标（表示MCP工具）。
   • 输入类似以下的查询：

     显示Twitter用户@OSINT_Ukraine的用户名变更历史
     

   • 预期输出：

     用户名变更历史记录如下：
     
     用户ID 4725638310:
     - The_HelpfulHand (2016-01-09至2020-09-27)
     - nftpromo_s (2022-02-10至2022-02-23)
     - OSINT_Ukraine (2022-02-24至2022-02-25)
     

示例查询

基础用法

查询@Mormonger： 工具输入：screen_name: "Mormonger" 输出：

用户名变更历史记录如下：

用户ID 1408886100:
- colenoorda (2016-04-02)
- Mormonger (2017-01-19至2025-02-25)

高级用法

查询无效的用户名： 工具输入：screen_name: "invalid_username" 输出：

没有找到用户信息。

📄 许可证

本项目遵循MIT许可证，具体内容请参阅LICENSE文件。