Twitter MCP Server

🚀 Twitter MCP 服务器用于 Claude Desktop

本项目是一个 Model Context Protocol (MCP) 服务器，它能让 Claude Desktop 与 Twitter 实现交互。借助该服务器，用户可在 Claude Desktop 中完成发布推文、分析推文内容，还能依据提示创作出结构完善的推文。

🚀 快速开始

此 MCP 服务器借助 Twitter API 把 Claude Desktop 和 Twitter 连接起来，具备以下多种实用功能：

• 资源：可访问您的 Twitter 个人资料、近期推文以及热门话题。
• 工具：支持发布推文、删除推文，还能对推文内容进行分析。
• 提示：提供用于创作简洁推文、Twitter 线程以及以吸引用户参与为目标的内容模板。

✨ 主要特性

资源

• 用户资料 (twitter://user/profile)：获取有关您的 Twitter 资料的信息。
• 最近推文 (twitter://user/tweets)：检索您最新的推文。
• 热门话题 (twitter://trends)：获取当前热门话题。

工具

• 发布推文：带有内容验证功能的新推文。
  • 参数：content（字符串，最多 280 字符），dryRun（可选布尔值）。
• 删除推文：通过 ID 删除推文。
  • 参数：tweetId（字符串）。
• 分析推文：检查推文内容的参与度潜力。
  • 参数：content（字符串，最多 280 字符）。

提示

• 简洁推文：创建简短、专注的推文。
  • 参数：topic（字符串），include_hashtags（布尔值），tone（枚举：专业，随意，幽默）。
• Twitter 线程：生成多推文线程。
  • 参数：topic（字符串），points（数字，2 - 5），include_call_to_action（布尔值）。
• 参与推文：创建设计用于高参与度的推文。
  • 参数：topic（字符串），engagement_type（枚举：问题，投票，热门观点，实用技巧）。

📦 安装指南

先决条件

• Node.js（v16 或更高版本）
• Claude Desktop
• 带有 API 密钥的 Twitter 开发者账户

安装步骤

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 并访问设置（从菜单，不在应用程序内）。
2. 点击左侧边栏中的“开发者”，然后点击“编辑配置”。
3. 将 Twitter MCP 服务器添加到您的配置中：

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

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

使用示例

配置完成后，您可以向 Claude Desktop 提出以下问题：

• “Twitter 上当前有哪些热门话题？”
• “起草一篇关于人工智能的专业推文”
• “创建一个包含 3 点的 Twitter 线程”
• “删除我的最新推文”
• “分析这条推文的参与度潜力”

文件结构

twitter-mcp-server/
├── index.js          # 主应用程序文件
├── server.js        # HTTP 服务器逻辑
└── .env              # 环境变量配置文件

故障排除指南

• 问题：无法启动服务器
  解决方法：检查 Node.js 是否正确安装，确认所有依赖项已安装，并确保 .env 文件中的凭据正确。
• 问题：推文未发布
  解决方法：检查 API 密钥是否有效，确认网络连接正常，并查看控制台的错误信息。

安全注意事项

• 确保 .env 文件安全，避免泄露敏感信息。
• 定期更新 API 凭据以维护账户安全。

📄 许可证

此项目受 MIT License 保护。