关键词

Twitter社交媒体推文搜索推文发布私信

Twikit MCP服务器使用说明

项目简介

Twikit MCP服务器是一个基于Model Context Protocol (MCP) 构建的后端服务，它作为一个桥梁，连接大型语言模型（LLM）客户端与Twitter平台。通过Twikit，LLM可以调用预设的工具来搜索Twitter上的信息、获取用户时间线、发布推文以及发送私信等，从而实现更丰富的基于Twitter数据的应用场景。

主要功能点

  • 推文搜索: 允许LLM根据关键词搜索Twitter上的公开推文，支持按热门或最新排序。
  • 用户推文获取: 可以获取指定用户的最新推文，包括用户的推文、回复等。
  • 时间线获取: 获取当前Twitter账号的首页时间线或关注者时间线。
  • 推文发布: 支持LLM通过工具调用发布新的推文，包括文本内容、图片/视频等多媒体内容，并支持回复特定推文和添加话题标签。
  • 私信发送: 允许LLM向指定用户发送私信，支持携带多媒体内容。
  • 推文和私信删除: 支持删除指定ID的推文或私信。
  • 速率限制处理: 内置简单的速率限制机制，避免频繁操作触及Twitter API的限制。

安装步骤

  1. 通过 Smithery 安装 (推荐 Claude Desktop 用户): 如果你的LLM客户端是 Claude Desktop 并且使用了 Smithery，可以使用以下命令快速安装 Twikit MCP服务器：

    npx -y @smithery/cli install mcp-twikit --client claude

    Smithery 会自动处理服务器的安装和配置。

  2. 手动安装: 如果需要手动安装，你需要确保你的环境中安装了 'uvx' (可能是用于虚拟环境管理的工具，具体安装方式请参考uvx文档) 和 'git'。然后，你可以按照以下步骤配置你的MCP客户端：

    a. 配置MCP服务器信息 (JSON 格式): 在你的MCP客户端配置中，添加或修改 'mcpServer' 部分，使其包含以下JSON配置。这会告诉客户端如何启动 Twikit MCP服务器。

    {
    "mcpServer": {
        "command": "uvx",
        "args": ["--from", "git+https://github.com/adhikasp/mcp-twikit", "mcp-twikit"],
        "env": {
            "TWITTER_USERNAME": "@your_twitter_username",  //  你的 Twitter 用户名 (例如 @example)
            "TWITTER_EMAIL": "[email protected]", // 你的 Twitter 注册邮箱
            "TWITTER_PASSWORD": "your_twitter_password",    // 你的 Twitter 密码
            "USER_AGENT": "Your-User-Agent-String (Optional)" // 可选: 自定义 User-Agent 字符串，用于请求头
        }
    }
}

    注意:

    • 请将 'TWITTER_USERNAME', 'TWITTER_EMAIL', 'TWITTER_PASSWORD' 替换为你自己的 Twitter 账号信息。 请务必妥善保管你的Twitter账号密码，避免泄露。
    • 'USER_AGENT' 是可选的，可以自定义 User-Agent 字符串，如果不需要可以删除该行。
    • 'command' 和 'args' 指定了启动 Twikit MCP 服务器的命令。 'uvx' 可能是用来从Git仓库安装和运行Python应用的工具。

基本使用方法

安装并配置好 Twikit MCP服务器后，你的LLM客户端应该能够通过MCP协议与之通信。 你可以使用类似 'mcp-client-cli' 这样的MCP客户端工具或者集成MCP客户端功能的LLM应用来与Twikit服务器交互。

示例 (使用 'mcp-client-cli'):

  1. 搜索关于特定话题的推文:

    llm search_twitter query:"人工智能 AND 伦理" sort_by:"Latest" count:10

    这条命令指示LLM调用 'search_twitter' 工具，搜索包含 "人工智能" 和 "伦理" 的最新10条推文。

  2. 获取个人时间线推文:

    llm get_timeline count:20

    这条命令指示LLM调用 'get_timeline' 工具，获取你Twitter账号首页时间线的最新20条推文。

  3. 发布推文:

    llm post_tweet text:"今天天气真好！ #好天气"

    这条命令指示LLM调用 'post_tweet' 工具，发布一条内容为 "今天天气真好！ #好天气" 的推文。

请注意:

  • 上述命令 'llm' 仅为示例，实际命令可能取决于你使用的MCP客户端的具体实现。
  • 你需要查阅你使用的MCP客户端的文档，了解如何配置和使用MCP服务器以及如何调用服务器提供的工具。
  • Twikit MCP服务器提供的工具名称包括： 'search_twitter', 'get_user_tweets', 'get_timeline', 'get_latest_timeline', 'post_tweet', 'delete_tweet', 'send_dm', 'delete_dm'。 你可以在LLM客户端中使用这些工具名称来调用相应的功能。

通过 Twikit MCP 服务器，你可以让你的LLM应用具备与Twitter平台交互的能力，实现更智能、更丰富的应用场景，例如舆情分析、信息监控、社交互动等。

信息

分类

通信与社交

访问项目