Building a Twitter Trends Analysis MCP Server for Claude

这个指南将帮助你建立一个模型上下文协议(MCP)服务器，将 Twitter 实时趋势与 Claude 的分析能力连接起来。

前提条件

• Python 3.8+
• Claude Desktop
• Twitter 开发者账户（带 API 访问权限）
• 基本 Python 知识

快速设置

1. 安装

# 创建项目目录并进入
mkdir twitter-trends-mcp && cd twitter-trends-mcp

# 设置虚拟环境
python -m venv .venv
.venv\Scripts\activate  # Windows
source .venv/bin/activate  # macOS/Linux

# 安装依赖
pip install tweepy mcp python-dotenv hatchling

2. 项目结构

创建以下目录和文件:

twitter-trends-mcp/
├── pyproject.toml
├── twitter_server_run.py
├── src/
│   └── twitter_trends_mcp/
│       ├── __init__.py
│       └── server.py

3. 配置 Twitter API

从 Twitter 开发者门户 获取:

• API Key 和 Secret
• Access Token 和 Secret
• Bearer Token

4. 核心文件设置

pyproject.toml:

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "twitter-trends-mcp"
version = "0.1.0"
description = "Twitter Trends MCP Server"
requires-python = ">=3.8"
dependencies = ["tweepy", "mcp", "python-dotenv"]

twitter_server_run.py:

#!/usr/bin/env python
import asyncio
import sys
from pathlib import Path

# 添加 src 到 Python 路径
sys.path.insert(0, str(Path(__file__).parent / "src"))

from twitter_trends_mcp.server import main

if __name__ == "__main__":
    asyncio.run(main())

5. 配置 Claude Desktop

编辑 Claude Desktop 配置文件:

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

{
  "mcpServers": {
    "twitter-trends": {
      "command": "C:\\Users\\YOUR_USERNAME\\twitter-trends-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\YOUR_USERNAME\\twitter-trends-mcp\\twitter_server_run.py"],
      "env": {
        "PYTHONPATH": "C:\\Users\\YOUR_USERNAME\\twitter-trends-mcp\\src",
        "PYTHONUNBUFFERED": "1"
      },
      "cwd": "C:\\Users\\YOUR_USERNAME\\twitter-trends-mcp"
    }
  }
}

6. 运行服务器

# 安装本地开发包
pip install -e .

# 启动服务器
python twitter_server_run.py

7. 使用 Claude

1. 打开 Claude Desktop
2. 点击 🔌 图标
3. 选择 "twitter-trends"
4. 尝试: "分析当前 Twitter 趋势以寻找 SaaS 机会"

故障排除

• 模块未找到: 检查 PYTHONPATH 配置
• 连接错误: 验证配置中的路径
• API 错误: 检查 Twitter 凭证
• 查看日志: twitter_server.log 或 %APPDATA%\Claude\Logs\mcp*.log

后续步骤

• 添加趋势历史跟踪
• 实现情感分析
• 扩展地区支持
• 自定义分析类别

---

这个 MCP 服务器让 Claude 能够访问 Twitter 实时趋势数据，提供商业洞察和机会识别。