🚀 Twitter MCP
这是一个用于与 Twitter API 进行交互的中间件 (MCP)，能简化集成和管理 Twitter 功能的过程。该服务器提供了一系列工具，可执行常见的 Twitter 操作，如发送推文、获取推文信息、处理用户互动等。
🚀 快速开始
此中间件能帮助你轻松与 Twitter API 交互，快速实现 Twitter 功能的集成与管理。
📦 安装指南
项目设置
- 克隆仓库：
git clone https://github.com/your-repository.git
- 安装依赖项：
npm install
- 配置环境变量：
创建
.env文件，并添加以下内容，将your-twitter-api-key等替换为实际的 Twitter API 凭证：
TWITTER_API_KEY=your-twitter-api-key
TWITTER_API_SECRET_KEY=your_twitter_api_secret_key
TWITTER_ACCESS_TOKEN=your_twitter_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_twitter_access_token_secret
- 启动服务器：
npm start
📚 详细文档
工具文档
可用工具分类
- 推文操作：发送推文、回复推文、删除推文。
- 搜索与分析：搜索推文、获取用户信息、分析 hashtag。
- 用户互动：关注/取消关注用户、管理粉丝列表。
- 列表管理：创建列表、添加/移除成员、获取列表信息。
详细工具说明
推文操作
- 发送推文 (
postTweet)：
POST /api/tweet/post
{
"text": "你的推文内容"
}
返回：推文 ID。
- 删除推文 (
deleteTweet)：
DELETE /api/tweet/{tweetId}
返回：确认删除成功消息。
搜索与分析
- 搜索推文 (
searchTweets)：
GET /api/search?q=查询词&count=结果数量
返回：匹配的推文列表。
- 获取用户信息 (
getUserInfo)：
GET /api/user/{username}
返回：用户详细资料，包括简介、粉丝数等。
用户互动
- 关注用户 (
followUser)：
POST /api/follow/{username}
返回：确认关注消息。
- 取消关注用户 (
unfollowUser)：
DELETE /api/follow/{username}
返回：确认取消关注消息。
列表管理
- 创建列表 (
createList)：
POST /api/list/create
{
"name": "列表名称",
"mode": "public" 或 "private"
}
返回：新列表 ID。
- 添加成员到列表 (
addToList)：
POST /api/list/{listId}/members
{
"username": "用户名"
}
返回：确认添加消息。
错误处理
所有工具均返回标准错误响应，包括参数缺失、API 错误等。详细错误码和信息请参考 API 文档。
🔧 技术细节
开发指南
快速开始
# 构建项目
npm run build
# 启动开发服务器（支持热重载）
npm run dev
术语表
| 属性 | 详情 |
|---|---|
| API Key | API 密钥 |
| Access Token | 访问令牌 |
| User Timeline | 用户时间线 |
感谢使用 Twitter MCP，如有任何问题，请联系支持团队。