金大哥 - twitter-mcp-server MCP 详情

article

README

🚀 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 开发者账户

安装步骤

克隆或下载此仓库

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

安装依赖项
```
npm install
```

在项目根目录中创建一个 .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 配置

打开 Claude Desktop 并访问设置（从菜单，不在应用程序内）。
点击左侧边栏中的“开发者”，然后点击“编辑配置”。
将 Twitter MCP 服务器添加到您的配置中：

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

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

使用示例

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

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

文件结构

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

故障排除指南

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

安全注意事项

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

📄 许可证

此项目受 MIT License 保护。

twitter-mcp-server