使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，专注于为 Claude 等大型语言模型 (LLM) 应用提供实时的 Twitter 趋势分析能力。它通过连接 Twitter API，获取实时的推特热点话题，并将这些信息以资源和工具的形式暴露给 LLM 客户端，从而增强 LLM 在社交媒体分析和商业洞察方面的能力。

主要功能点

实时 Twitter 趋势获取: 服务器能够实时从 Twitter API 获取指定地区的 trending topics。
资源管理: 将 Twitter 趋势数据作为资源进行管理，允许 LLM 客户端通过标准化的 MCP 协议访问和获取。
工具注册与执行: 提供工具接口，允许 LLM 客户端调用服务器端的功能，例如对 Twitter 趋势进行分析，挖掘商业机会。
Claude 集成: 专门为 Claude 设计，通过 MCP 协议无缝集成到 Claude Desktop 应用中，扩展 Claude 的上下文信息来源。
详细日志: 提供全面的日志记录，方便开发者调试和监控服务器运行状态。

安装步骤

环境准备: 确保已安装 Python 3.8 或更高版本，并已安装 Claude Desktop 客户端。
获取 Twitter API 凭据: 访问 Twitter Developer Portal 创建应用并获取 API Key, API Secret, Access Token, Access Token Secret, Bearer Token 等凭据。
下载项目: 克隆或下载此 GitHub 仓库到本地。
创建虚拟环境: 在项目根目录下打开终端，运行 'python -m venv .venv' 创建虚拟环境，并根据你的操作系统激活虚拟环境（例如，Windows 下运行 '.venv\Scripts\activate'，Linux/macOS 下运行 'source .venv/bin/activate'）。
安装依赖: 在虚拟环境中运行 'pip install -e .' 安装项目依赖。

服务器配置

为了让 Claude Desktop 客户端连接到此 MCP 服务器，您需要编辑 Claude 的配置文件 'claude_desktop_config.json'。该文件通常位于：

Windows: '%APPDATA%\Claude\claude_desktop_config.json'
macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'

在 'claude_desktop_config.json' 文件的 '"mcpServers"' 部分添加以下配置信息。请根据您的实际项目路径替换 'YOUR_USERNAME' 等占位符。

"twitter-trends": {
  "command": "C:\\Users\\YOUR_USERNAME\\twitter-trends-mcp\\.venv\\Scripts\\python.exe",  // Python 解释器路径 (虚拟环境中的 Python)
  "args": ["C:\\Users\\YOUR_USERNAME\\twitter-trends-mcp\\twitter_server_run.py"], // 服务器启动脚本路径
  "env": {
    "PYTHONPATH": "C:\\Users\\YOUR_USERNAME\\twitter-trends-mcp\\src", // src 目录路径，确保 Python 可以找到 server 模块
    "PYTHONUNBUFFERED": "1" // 避免输出缓冲，实时查看日志
  },
  "cwd": "C:\\Users\\YOUR_USERNAME\\twitter-trends-mcp" // 项目根目录
}

请注意: 'command' 和 'args' 配置是 Claude 客户端连接 MCP 服务器的关键，请务必根据您的实际环境配置正确的文件路径。'server name' (此处为 "twitter-trends") 是您在 Claude 客户端中识别和启用此服务器的名称，可以自定义。

基本使用方法

启动服务器: 在项目根目录下，激活虚拟环境后，运行命令 'python twitter_server_run.py' 启动 MCP 服务器。
连接 Claude: 打开 Claude Desktop 客户端，点击插件图标 (通常是 🔌 符号)，在插件列表中应该能看到名为 "twitter-trends" 的 MCP 服务器。启用该服务器。
与 Claude 交互: 现在您可以向 Claude 提出与 Twitter 趋势相关的问题，例如 "分析当前 Twitter 趋势，寻找 SaaS 领域的商业机会"。Claude 将通过 MCP 协议与服务器通信，获取 Twitter 趋势数据并进行分析。
查看日志: 服务器日志文件为 'twitter_server.log'，Claude 客户端的 MCP 相关日志位于 '%APPDATA%\Claude\Logs\mcp*.log' (Windows) 或 '~/Library/Application Support/Claude/Logs/mcp*.log' (macOS)。通过查看日志可以帮助您诊断问题。

关键词