使用说明

项目简介

本项目 'Twitter MCP Server for Claude' 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在将 Claude 桌面应用与 Twitter (X) 平台连接起来。通过此服务器,您可以使用 Claude 与 Twitter 进行交互,例如获取您的 Twitter 个人资料、发布推文、分析推文内容等。

主要功能点

  • 资源 (Resources)
    • 用户个人资料:获取您的 Twitter 账户信息,如用户名、 bio、粉丝数等。
    • 最近的推文:检索您最新的推文列表。
    • 热门话题:获取 Twitter 当前的热门话题。
  • 工具 (Tools)
    • 发布推文:发布新的推文内容。
    • 删除推文:删除指定 ID 的推文。
    • 分析推文:分析推文内容的潜在互动性。
  • Prompt 模板 (Prompts)
    • 简洁推文:根据主题生成简短精炼的推文。
    • Twitter 串文:根据主题生成多条推文的串文。
    • 互动推文:创建旨在提高用户参与度的推文,如提问、投票等。

安装步骤

  1. 克隆仓库 打开终端,执行以下命令克隆仓库到本地:

    git clone https://github.com/SouravKumarBarman/twitter-mcp-server
    cd twitter-mcp-server
  2. 安装依赖 在仓库目录下,执行以下命令安装项目所需的依赖:

    npm install
  3. 配置 Twitter API 密钥 在项目根目录下创建 '.env' 文件,并填入您的 Twitter API 密钥。您需要在 Twitter Developer Platform 获取这些密钥。

    TWITTER_API_KEY=您的_API_密钥
    TWITTER_API_SECRET=您的_API_密钥_Secret
    TWITTER_ACCESS_TOKEN=您的_Access_Token
    TWITTER_ACCESS_SECRET=您的_Access_Token_Secret

    请将 '您的_API_密钥'、'您的_API_密钥_Secret'、'您的_Access_Token'、'您的_Access_Token_Secret' 替换为您实际的 API 密钥。

服务器配置

要将此 MCP 服务器与 Claude 桌面应用连接,您需要修改 Claude 的开发者配置。

  1. 打开 Claude 桌面应用的设置 (注意:是从 Claude 应用的菜单栏进入设置,而不是在应用内的设置)。

  2. 进入开发者选项,在左侧边栏点击 "Developer",然后点击 "Edit Config"。

  3. 添加 Twitter MCP 服务器配置,在打开的配置文件中,找到 '"mcpServers"' 部分,添加以下 JSON 配置:

    {
        "mcpServers": {
            "Twitter Assistant": {
                "command": "npm",
                "args": [
                    "--prefix",
                    "/path/to/twitter-mcp-server",  // 将 "/path/to/twitter-mcp-server" 替换为您的 "twitter-mcp-server" 仓库的绝对路径
                    "start"
                ]
            }
        }
    }

    配置参数说明:

    • '"Twitter Assistant"': 服务器名称,您可以自定义,Claude 桌面应用中会显示此名称。
    • '"command": "npm"': 启动服务器的命令,这里使用 'npm'。
    • '"args"': 传递给 'npm' 命令的参数列表。
      • '"--prefix"': 指定项目前缀路径。
      • '"/path/to/twitter-mcp-server"': 请务必替换为您的 'twitter-mcp-server' 仓库在您电脑上的 完整绝对路径。 例如,如果您的仓库在 '/Users/yourname/Documents/twitter-mcp-server',则应替换为 '/Users/yourname/Documents/twitter-mcp-server'。
      • '"start"': 'npm start' 命令会执行 'package.json' 中定义的 'start' 脚本,该脚本通常会启动服务器。
  4. 保存配置文件并重启 Claude 桌面应用

基本使用方法

配置完成后,您可以在 Claude 桌面应用中通过自然语言指令来使用 Twitter MCP 服务器的功能。例如:

  • 查询热门话题:在 Claude 中提问 "What are the current trending topics on Twitter?"
  • 撰写推文:让 Claude 帮您写推文,例如 "Draft a professional tweet about artificial intelligence"。
  • 创建串文:要求 Claude 创建 Twitter 串文,例如 "Create a Twitter thread about climate change with 3 points"。
  • 分析推文:分析推文内容,例如 "Analyze this tweet: [您的推文内容]"。
  • 发布推文:发布推文,例如 "Post this tweet: Just learned how to connect Claude with Twitter!"

注意: 首次执行发布或删除推文等敏感操作时,服务器可能会请求您进行确认,请仔细审核后再操作。

信息

分类

通信与社交