datawhisker/x-mcp-server
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
datawhisker/x-mcp-сервер — кандидат на сервер MCP, импортированный из https://github.com/datawhisker/x-mcp-server.
Обзор
datawhisker/x-mcp-сервер — кандидат на сервер MCP, импортированный из https://github.com/datawhisker/x-mcp-server.
Обзор (машинный перевод)
Сервер Model Context Protocol (MCP) для интеграции с X (Twitter). Предоставляет 26 инструментов для чтения временных линий, публикации, поиска, взаимодействия (лайки, ретвиты, закладки), поиска пользователей, экспорта подписчиков, упоминаний, лайков, статей и списков. Предназначен для использования с настольными компьютерами Claude и другими MCP-совместимыми клиентами.
Особенности
Timeline & Search - Домашняя временная шкала, поиск последних сообщений (7-дневное окно) Управление сообщениями - Создавать, отвечать, цитировать, удалять сообщения с дополнительными носителями ** Взаимодействие** - Like/unlike, retweet/undo, bookmark/unbookmark ** Данные пользователя** - Упоминания, понравившиеся посты, подписчики, подписчики, блоки, мьюты, собственные списки, списки и списки членства Пользовательский поиск - Получите профили пользователей и их последние сообщения Media Upload - Изображения (PNG, JPEG, GIF, WEBP) и видео (MP4, MOV, AVI, WEBM, M4V) через API загрузки v2 Dual Auth - OAuth 1.0a для почтовых операций, OAuth 2.0 для загрузки в СМИ (v1.1 заход в июне 2025 года) ** Ограничение скорости ** - автоматическое отслеживание предельной скорости с четкими сообщениями об ошибках TypeScript - Полная безопасность типа, модульная файловая структура
Предпосылки
Node.js >= 18.0.0 X (Twitter) аккаунт разработчика
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
X MCP Server
A Model Context Protocol (MCP) server for X (Twitter) integration. Provides 26 tools for reading timelines, posting, searching, engagement (likes, retweets, bookmarks), user lookup, follower export, mentions, likes, articles, and lists. Designed for use with Claude desktop and other MCP-compatible clients.
Features
- Timeline & Search - Home timeline, search recent posts (7-day window)
- Post Management - Create, reply, quote, delete posts with optional media
- Engagement - Like/unlike, retweet/undo, bookmark/unbookmark
- User Data - Mentions, liked posts, followers, following, blocks, mutes, owned lists, followed lists, and list memberships
- User Lookup - Get user profiles and their recent posts
- Media Upload - Images (PNG, JPEG, GIF, WEBP) and videos (MP4, MOV, AVI, WEBM, M4V) via v2 upload API
- Dual Auth - OAuth 1.0a for post operations, OAuth 2.0 for media upload (v1.1 upload was sunset June 2025)
- Rate Limiting - Automatic per-endpoint rate limit tracking with clear error messages
- TypeScript - Full type safety, modular file structure
Prerequisites
- Node.js >= 18.0.0
- X (Twitter) Developer Account
- Claude desktop app (or any MCP-compatible client)
X API Access & Pricing
| Tier | Cost | Post Reads | Post Writes | Notes |
|---|---|---|---|---|
| Free | $0 | ~100/month | ~500/month | No likes/follows; media upload requires OAuth 2.0 |
| Basic | $200/month | 10,000/month | 3,000/month | Search, limited read access |
| Pro | $5,000/month | 1,000,000/month | 300,000/month | Full search, filtered stream |
| Pay-Per-Use | Credit-based | ~$0.005/read | Varies | Launched Feb 2026, 2M reads cap |
Like and Follow endpoints were removed from the Free tier in August 2025. Follows/Blocks endpoints are Enterprise-only as of 2025.
Installation
git clone https://github.com/DataWhisker/x-mcp-server.git
cd x-mcp-server
npm install
npm run build
Authentication
The server supports two authentication methods. You need at least one configured.
OAuth 1.0a (Required for basic operations)
Works for all post/engagement/search/user operations.
| Environment Variable | Description |
|---|---|
TWITTER_API_KEY |
Consumer Key (API Key) |
TWITTER_API_SECRET |
Consumer Secret (API Key Secret) |
TWITTER_ACCESS_TOKEN |
User Access Token |
TWITTER_ACCESS_SECRET |
User Access Token Secret |
Setup: In the X Developer Portal:
- Create a project and app
- Enable OAuth 1.0a under “User authentication settings”
- Set permissions to “Read and Write”
- Generate Consumer Keys and Access Tokens
OAuth 2.0 (Required for media upload)
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"x": {
"command": "node",
"args": ["C:/path/to/x-mcp-server/build/index.js"],
"env": {
"TWITTER_API_KEY": "your-api-key",
"TWITTER_API_SECRET": "your-api-secret",
"TWITTER_ACCESS_TOKEN": "your-access-token",
"TWITTER_ACCESS_SECRET": "your-access-secret",
"TWITTER_OAUTH2_ACCESS_TOKEN": "your-oauth2-token"
}
}
}
}