Twitter MCP Server for Claude Desktop

面向 Claude Desktop 的 Twitter MCP 服务

一个模型上下文协议（MCP）服务，可让 Claude Desktop 与 Twitter 交互——发布推文、分析内容，并根据提示词创作结构清晰的推文。

概述

此 MCP 服务通过 Twitter API 将 Claude Desktop 连接到 Twitter，并提供以下功能：

• 资源：访问你的 Twitter 个人资料、近期推文和热门话题
• 工具：发布推文、删除推文和分析推文内容
• 提示词：用于创作简洁推文、Twitter 主题串和注重互动的内容的模板

前提条件

• Node.js（v16 或更高版本）
• Claude Desktop
• Twitter 开发者账号及 API 密钥

安装

1. 克隆或下载此仓库

   git clone https://github.com/yourusername/twitter-mcp-server
   cd twitter-mcp-server
   

2. 安装依赖项

   npm install
   

3. 在项目根目录中创建 .env 文件，并填入你的 Twitter API 凭据

   TWITTER_API_KEY=your_api_key
   TWITTER_API_SECRET=your_api_secret
   TWITTER_ACCESS_TOKEN=your_access_token
   TWITTER_ACCESS_SECRET=your_access_secret
   

使用 Claude Desktop 进行设置

1. 打开 Claude Desktop 并进入设置（从 Claude 菜单进入，而非应用内）
2. 点击左侧边栏中的“Developer”，然后点击“Edit Config”
3. 在配置中添加 Twitter MCP 服务：

{
    "mcpServers": {
        "Twitter Assistant": {
            "command": "npm",
            "args": [
                "--prefix",
                "/full/path/to/twitter-mcp-server.js",
                "start"
            ]
        }
    }
}

4. 将 /full/path/to/twitter-mcp-server.js 替换为服务文件的实际路径
5. 保存配置文件并重启 Claude Desktop

功能

资源

• 用户个人资料（twitter://user/profile）：获取 Twitter 个人资料信息
• 近期推文（twitter://user/tweets）：获取你最近发布的推文
• 热门话题（twitter://trends）：获取当前热门话题

工具

• 发布推文：验证内容后发布新推文

  • 参数：content（字符串，最多 280 个字符）、dryRun（布尔值，可选）

• 删除推文：根据 ID 删除推文

  • 参数：tweetId（字符串）

• 分析推文：评估推文内容的互动潜力

  • 参数：content（字符串，最多 280 个字符）

提示词

• 简洁推文：创作简短、主题明确的推文

  • 参数：topic（字符串）、include_hashtags（布尔值）、tone（枚举：professional、casual、humorous）

• Twitter 主题串：生成包含多条推文的主题串

  • 参数：topic（字符串）、points（数字，2-5）、include_call_to_action（布尔值）

• 互动型推文：创作旨在获得高互动的推文

  • 参数：topic（字符串）、engagement_type（枚举：question、poll、hot-take、useful-tip）

使用示例

配置完成后，你可以向 Claude Desktop 提出以下请求：

• “Twitter 上当前有哪些热门话题？”
• “起草一条关于人工智能的专业推文”
• “围绕气候变化创建一个包含 3 个要点的 Twitter 主题串”
• “分析这条推文：[你的推文内容]”
• “发布这条推文：刚学会如何将 Claude 连接到 Twitter！”

文件结构

twitter-mcp-server/
├── twitter-mcp-server.js  # Main server file
├── .env                   # Environment variables (API keys)
├── package.json           # Project dependencies
└── README.md              # This file

故障排除

• Twitter API 错误：检查你的 API 凭据和权限
• 找不到服务：检查配置中的路径是否正确
• 找不到模块：确保已安装所有依赖项（npm install）
• 连接问题：配置更改后，务必重启 Claude Desktop

安全说明

此服务使用你的用户账号权限运行。发布或删除推文前会请求确认，但在批准操作前，请务必先检查操作内容。

许可证

MIT

参与贡献

欢迎贡献！请随时提交 Pull Request。