X.com MCP服务器
提供对X.com的API功能的访问的模型上下文协议服务器。此服务器使LLM能够通过OAuth 2.0身份验证与X.com（以前的Twitter）进行交互，支持所有与帖子相关的主要操作，包括阅读、写作、搜索和管理帖子、点赞、转发和书签。
特性
- OAuth 2.0身份验证 -安全承载令牌身份验证
- API发布后的完整报道 -来自官方API的所有X.com Post终结点
- 类型安全 -带有Zod验证的完整TypeScript实现
- 综合工具 -涵盖所有主要X.com操作的21个工具
可用工具
查找
getSinglePost-使用可选字段扩展按ID检索单个帖子getBulkPosts-通过ID检索最多100个帖子
管理帖子
createPost-使用文本、媒体、民意调查、回复等创建新帖子。deletePost-按ID删除帖子hideReply-隐藏或取消隐藏对帖子的回复
时间线
getUserTimeline-获取用户的帖子时间线getUserMentions-获取提及特定用户的帖子
搜索
searchRecent-搜索最近的帖子（过去7天）searchAll-搜索所有帖子（完整存档-需要学术/企业访问权限）
帖子计数
getPostCountsRecent-获取最近帖子的时间戳帖子计数getPostCountsAll-获取所有帖子（学术/企业）的时间戳帖子计数
推数
getRetweets-获取转发特定帖子的帖子createRetweet-转发帖子deleteRetweet-删除转发
喜欢
getLikingUsers-获取喜欢特定帖子的用户getLikedTweets-获取用户喜欢的帖子likePost-喜欢帖子unlikePost-与帖子不同
书签
getUserBookmarks-获取用户的书签帖子bookmarkPost-为帖子添加书签removeBookmark-删除书签
安装
使用pnpm（推荐）
pnpm install
pnpm run build安装后，您可以使用以下命令运行它：
node dist/index.js使用Docker
docker build -t x.com-mcp .
docker run -i --rm -e X_COM_ACCESS_TOKEN=your-access-token x.com-mcp配置
环境变量
X_COM_ACCESS_TOKEN（必填）：您的X.com OAuth 2.0访问令牌
身份验证设置
- 在以下位置创建X.com开发人员帐户 developer.x.com
- 创建新项目和应用程序
- 生成OAuth 2.0凭据
- 使用PKCE流实现OAuth 2.0授权码
- 将生成的访问令牌存储为
X_COM_ACCESS_TOKEN
为Claude.app进行配置
添加到您的Claude设置中：
Using pnpm
"mcpServers": {
"x-com": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"X_COM_ACCESS_TOKEN": "your-access-token"
}
}
}Using Docker
"mcpServers": {
"x-com": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "X_COM_ACCESS_TOKEN=your-access-token", "x.com-mcp"]
}
}交互示例
- 创建帖子：
{
"name": "createPost",
"arguments": {
"text": "Hello world! This is my first post via the MCP server.",
"reply_settings": "everyone"
}
}- 搜索最近的帖子：
{
"name": "searchRecent",
"arguments": {
"query": "artificial intelligence",
"max_results": 10,
"tweet.fields": "created_at,author_id,public_metrics"
}
}- 获取用户时间线：
{
"name": "getUserTimeline",
"arguments": {
"id": "123456789",
"max_results": 20,
"expansions": "author_id"
}
}- 就像一篇帖子：
{
"name": "likePost",
"arguments": {
"user_id": "123456789",
"tweet_id": "987654321"
}
}- 获取帖子计数：
{
"name": "getPostCountsRecent",
"arguments": {
"query": "machine learning",
"granularity": "day"
}
}涵盖API终点
此服务器实现X.com API v2规范中的所有与发布相关的终结点：
- 查找:
/2/tweets/:id,/2/tweets - 管理帖子:
/2/tweets（POST），/2/tweets/:id（删除），/2/tweets/:id/hidden（PUT） - 时间线:
/2/users/:id/tweets,/2/users/:id/mentions - 搜索:
/2/tweets/search/recent,/2/tweets/search/all - 帖子计数:
/2/tweets/counts/recent,/2/tweets/counts/all - 推数:
/2/tweets/:id/retweets,/2/users/:id/retweets - 喜欢:
/2/tweets/:id/liking_users,/2/users/:id/liked_tweets,/2/users/:id/likes - 书签:
/2/users/:id/bookmarks
所需范围
确保您的X.com应用程序具有以下OAuth 2.0作用域：
tweet.read-阅读帖子和用户信息tweet.write-创建和删除帖子tweet.moderate.write-隐藏/取消隐藏回复users.read-读取用户信息like.read-阅读喜欢信息like.write-喜欢和不喜欢的帖子bookmark.read-阅读书签bookmark.write-创建和删除书签
调试
您可以使用MCP检查器调试服务器：
npx @modelcontextprotocol/inspector node dist/index.js给克劳德的问题示例
- “你能搜索最近关于人工智能的帖子吗？”
- “写一篇关于TypeScript好处的帖子。”
- “找到提到机器学习的帖子，并展示他们的参与度指标。”
- “获取我最近的书签并分析主题。”
构建
# Install dependencies
pnpm install
# Build TypeScript
pnpm run build
# Start server
pnpm start速率限制
请注意X.com API费率限制：
- 大多数读取操作：每15分钟300个请求
- 写入操作：每15分钟50个请求
- 书签操作：每15分钟50次写入/180次读取
请参阅 X.com API文档 获取详细的速率限制信息。