Twitter MCP Server

基本能力

产品定位

mcp-twitter-server 是一个 Twitter API 的集成服务，通过 MCP 协议提供标准化的 Twitter 功能接口，适用于需要与 Twitter 进行交互的应用开发。

核心功能

1. 推文操作：发布推文、回复推文、删除推文、发布带媒体的推文等。
2. 搜索与分析：搜索推文、获取话题分析数据。
3. 用户操作：获取用户信息、用户时间线、关注者列表、关注列表等。
4. 互动管理：点赞、取消点赞、转发、取消转发等。
5. 列表管理：创建列表、添加用户到列表、从列表中移除用户等。

适用场景

1. 社交媒体管理工具：用于自动化发布推文、管理互动等。
2. 数据分析工具：用于获取推文和用户数据进行分析。
3. 客户支持工具：用于通过 Twitter 与客户互动。
4. 内容聚合工具：用于聚合特定话题或用户的推文。

工具列表

1. postTweet：发布新推文。
2. postTweetWithMedia：发布带媒体的推文。
3. getTweetById：通过 ID 获取推文。
4. replyToTweet：回复推文。
5. deleteTweet：删除推文。
6. searchTweets：搜索推文。
7. getHashtagAnalytics：获取话题分析数据。
8. getUserInfo：获取用户信息。
9. getUserTimeline：获取用户时间线。
10. getFollowers：获取用户关注者列表。
11. getFollowing：获取用户关注列表。
12. likeTweet：点赞推文。
13. unlikeTweet：取消点赞。
14. retweet：转发推文。
15. undoRetweet：取消转发。
16. getRetweets：获取转发用户列表。
17. getLikedTweets：获取用户点赞的推文。
18. createList：创建列表。
19. addUserToList：添加用户到列表。
20. removeUserFromList：从列表中移除用户。
21. getListMembers：获取列表成员。

常见问题解答

1. 错误处理：所有工具返回标准化的错误响应，包括缺少参数、API 错误和未找到资源等。
2. 响应格式：所有成功响应遵循统一的 JSON 格式。
3. 开发调试：提供了构建、启动和监视模式的命令。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 克隆仓库：git clone <repository-url>
3. 安装依赖：npm install

安装教程

1. 复制 .env.example 到 .env 并填写 Twitter API 凭证： env X_API_KEY=your_api_key X_API_SECRET=your_api_secret X_ACCESS_TOKEN=your_access_token X_ACCESS_TOKEN_SECRET=your_access_token_secret
2. 构建项目：npm run build
3. 启动服务器：npm start

调试方式

1. 开发模式：npm run dev
2. 查看日志：服务器启动后，控制台会输出运行日志。
3. 测试工具：使用 Postman 或 curl 测试 API 接口。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。