关键词

Twitter私信X私信社交媒体分析消息搜索用户会话

MCP Server for X/Twitter 使用说明

项目简介

mcp-x 是一个基于 Model Context Protocol (MCP) 的服务器实现，专注于为大型语言模型 (LLM) 提供访问和分析 Twitter (X) 私信 (Direct Messages, DMs) 的能力。通过 mcp-x 服务器，LLM 应用可以搜索特定关键词的私信、获取用户之间的对话记录、分析用户消息统计等，从而实现更智能的社交媒体内容理解和交互。

主要功能点

  • 私信搜索: 支持根据文本内容、用户名、会话 ID 等多种条件搜索 Twitter 私信。
  • 会话管理: 获取指定会话的消息列表，以及用户参与的所有会话 ID。
  • 用户分析: 查询用户在私信中的活动统计信息，包括发送和接收的消息数量、参与的会话数等。
  • 用户信息: 根据用户名或用户 ID 获取用户的基本信息。
  • 消息统计: 获取指定会话或所有私信的消息统计数据。

安装步骤

  1. 确保已安装 Python 和 pip。
  2. 打开终端或命令提示符，运行以下命令安装 'mcp-x'： 
    pip install mcp-x

服务器配置

为了让 MCP 客户端能够连接到 mcp-x 服务器，您需要提供如下配置信息。这个配置告诉 MCP 客户端如何启动和连接到 mcp-x 服务器。

{
  "server_name": "mcp-x-server",
  "command": "python",
  "args": ["-m", "mcp_x.server"]
  // "server_name" 是服务器的名称，可以自定义。
  // "command" 是启动服务器的命令，这里使用 python 解释器。
  // "args" 是命令的参数，"-m mcp_x.server" 表示运行 mcp_x 包中的 server 模块，即启动 mcp-x 服务器。
  // 假设您的 Python 环境配置正确，可以直接使用 python 命令。
}

注意: 请确保您的 Python 环境已经添加到系统 PATH 环境变量中，这样 MCP 客户端才能正确找到 'python' 命令。

基本使用方法

  1. 启动服务器: MCP 客户端会根据您提供的配置信息自动启动 mcp-x 服务器。
  2. 客户端请求: LLM 应用通过 MCP 客户端发送 JSON-RPC 请求到 mcp-x 服务器，调用预定义的工具 (Tools) 来执行不同的私信操作。例如，调用 'search_by_text' 工具搜索包含特定关键词的私信。
  3. 服务器响应: mcp-x 服务器接收到请求后，会调用相应的函数处理请求，并返回 JSON-RPC 响应给 MCP 客户端，最终传递给 LLM 应用。

示例工具调用 (在 MCP 客户端中)

假设您想使用 'search_by_text' 工具搜索包含 "example" 关键词的私信，您需要构造一个符合 MCP 协议的 JSON-RPC 请求，并发送给 mcp-x 服务器。具体的请求格式和工具参数请参考 MCP 协议文档和 mcp-x 服务器的代码定义。

// 示例 JSON-RPC 请求 (仅供参考，具体格式请查阅 MCP 协议)
{
  "jsonrpc": "2.0",
  "method": "call_tool",
  "params": {
    "tool_name": "search_by_text",
    "arguments": {
      "query": "example",
      "limit": 5
    }
  },
  "id": "1"
}

请注意，这只是一个简化的使用说明。实际应用中，您需要结合 MCP 客户端的具体使用方法，并参考 mcp-x 服务器的代码来了解更详细的工具功能和参数。

信息

分类

通信与社交

访问项目