Twitterio

这是一个基于Model Context Protocol (MCP)的Twitter API客户端，使用twitterapi.io的API服务来获取Twitter数据。该服务允许AI助手（如Claude）查询Twitter数据，包括用户信息、推文、趋势等。

功能

• 获取用户信息和用户关系数据（粉丝、关注）
• 搜索和获取推文，包括用户时间线、列表推文
• 获取推文详情、回复、引用和转发信息
• 高级推文搜索功能

环境要求

• Python 3.12或更高版本
• mcp库 >= 1.6.0
• httpx >= 0.28.1
• python-dotenv >= 1.0.0 (可选，用于加载环境变量)

安装

1. 确保你已安装必要的依赖：

   pip install "mcp>=1.6.0" "httpx>=0.28.1" "python-dotenv>=1.0.0"
   

   或者使用uv：

   uv pip install "mcp>=1.6.0" "httpx>=0.28.1" "python-dotenv>=1.0.0"
   

2. 设置Twitter API密钥：

   export TWITTER_API_KEY="your_api_key_here"
   

   或者创建一个.env文件：

   TWITTER_API_KEY=your_api_key_here
   

使用方法

使用uvx命令直接在Cherry Studio等终端中使用

本项目已经上传到PyPI，可直接通过uvx在Cherry Studio中使用：

mcp-twitterio

需要从twitterapi.io官网获得TWITTER_API_KEY作为环境变量。

Cherry Studio使用示例

在Cherry Studio中使用mcp-twitterio服务：

查询Twitter用户信息示例：

使用MCP CLI运行服务

mcp dev main.py

这将使用MCP Inspector启动服务，可通过本地网页界面测试其功能。

安装到Claude Desktop

要在Claude Desktop中使用此服务：

mcp install main.py --name "Twitter API"

直接执行

python main.py

可用的工具

用户相关工具

1. get_user_info_by_username - 根据用户名获取Twitter用户信息
2. batch_get_users_by_ids - 批量获取用户信息
3. get_user_last_tweets - 获取用户最新的推文
4. get_user_followers - 获取用户的粉丝列表
5. get_user_followings - 获取用户的关注列表
6. get_user_mentions - 获取用户被提及的推文

推文相关工具

7. get_tweets_by_ids - 通过推文ID获取推文
8. get_tweet_replies - 获取推文的回复
9. get_tweet_quotations - 获取引用推文的推文
10. get_tweet_retweeters - 获取转发推文的用户
11. get_list_tweets - 获取列表中的推文
12. advanced_search_tweets - 高级搜索推文

示例使用场景

使用Claude与此MCP服务的交互示例：

1. 获取用户信息： "请获取Twitter用户'elonmusk'的个人资料信息。"

2. 搜索推文： "请通过高级搜索找到关于'人工智能'的最新推文，限制结果为5条。"

3. 查看用户推文： "显示用户'elonmusk'的最新3条推文。"

4. 获取推文回复： "获取ID为'1234567890'的推文的所有回复。"

5. 了解推文引用： "查看有哪些用户引用了ID为'1234567890'的推文。"

注意事项

• 你需要一个有效的twitterapi.io API密钥才能使用此服务
• 某些API调用可能受到twitterapi.io的速率限制
• 确保遵守Twitter的服务条款和API使用政策

开发与测试

项目包含examples目录中的客户端示例代码，可用于了解如何从Python程序中调用此MCP服务。 tests目录包含基本的单元测试，可确保服务核心功能正常工作。