X (Twitter)

🚀 Twitter MCP

这是一个用于与 Twitter API 进行交互的中间件 (MCP)，能简化集成和管理 Twitter 功能的过程。该服务器提供了一系列工具，可执行常见的 Twitter 操作，如发送推文、获取推文信息、处理用户互动等。

🚀 快速开始

此中间件能帮助你轻松与 Twitter API 交互，快速实现 Twitter 功能的集成与管理。

📦 安装指南

项目设置

1. 克隆仓库：

git clone https://github.com/your-repository.git

2. 安装依赖项：

npm install

3. 配置环境变量： 创建 .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

4. 启动服务器：

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

术语表

感谢使用 Twitter MCP，如有任何问题，请联系支持团队。