Twitter MCP サーバー

Twitter API 統合のためのモデルコンテキストプロトコルサーバーの実装。

設定

リポジトリをクローンする
依存関係をインストール: npm install
.env.exampleを.envにコピーし、Twitter API の認証情報を入力します。
プロジェクトをビルドします: npm run build
サーバーを起動します: npm start

Related MCP server: MCP-Twikit

環境変数

.envに必要な Twitter API 認証情報:

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

利用可能なツール

ツイート操作

postTweet : 新しいツイートを投稿する
{ "text": "Your tweet text here" }
postTweetWithMedia : メディアを添付したツイートを投稿する
{ "text": "Your tweet text", "mediaPath": "path/to/media/file", "mediaType": "image/jpeg|image/png|image/gif|video/mp4", "altText": "Optional alt text for accessibility" }
getTweetById : IDで特定のツイートを取得する
{ "tweetId": "tweet_id", "tweetFields": ["created_at", "public_metrics"] }
replyToTweet : 既存のツイートに返信する
{ "tweetId": "tweet_id", "text": "Your reply text" }
deleteTweet : ツイートを削除する
{ "tweetId": "tweet_id" }

検索と分析

searchTweets : ツイートを検索
{ "query": "search query", "maxResults": 10, "tweetFields": ["created_at", "public_metrics"] }
getHashtagAnalytics : ハッシュタグの分析情報を取得する
{ "hashtag": "hashtag", "startTime": "ISO-8601 date", "endTime": "ISO-8601 date" }

ユーザー操作

getUserInfo : ユーザー情報を取得する
{ "username": "twitter_username", "fields": ["description", "public_metrics"] }
getUserTimeline : ユーザーのツイートを取得する
{ "username": "twitter_username", "maxResults": 10, "tweetFields": ["created_at", "public_metrics"] }
getFollowers : ユーザーのフォロワーを取得する
{ "username": "twitter_username", "maxResults": 100, "userFields": ["description", "public_metrics"] }
getFollowing : ユーザーがフォローしているアカウントを取得する
{ "username": "twitter_username", "maxResults": 100, "userFields": ["description", "public_metrics"] }

婚約

likeTweet : ツイートにいいねする
{ "tweetId": "tweet_id" }
ツイートをunlikeTweetしない
{ "tweetId": "tweet_id" }
retweet : ツイートをリツイートする
{ "tweetId": "tweet_id" }
undoRetweet : リツイートを元に戻す
{ "tweetId": "tweet_id" }
getRetweets : ツイートをリツイートしたユーザーを取得する
{ "tweetId": "tweet_id", "maxResults": 100, "userFields": ["description", "public_metrics"] }
getLikedTweets : ユーザーが「いいね！」したツイートを取得する
{ "userId": "user_id", "maxResults": 100, "tweetFields": ["created_at", "public_metrics"] }

リスト管理

createList : 新しいリストを作成する
{ "name": "List name", "description": "List description", "isPrivate": false }
addUserToList : ユーザーをリストに追加する
{ "listId": "list_id", "username": "twitter_username" }
removeUserFromList : リストからユーザーを削除する
{ "listId": "list_id", "username": "twitter_username" }
getListMembers : リストのメンバーを取得する
{ "listId": "list_id", "maxResults": 100, "userFields": ["description", "public_metrics"] }

エラー処理

すべてのツールは標準化されたエラー応答を返します。

不足しているパラメータ: Missing required parameter: parameter_name
APIエラー: Twitter APIからのエラーメッセージ
見つからないエラー: リソースに適切な「見つからない」メッセージ

応答フォーマット

すべての成功した応答は次の形式に従います。

{ "content": [ { "type": "text", "text": "Operation result message" } ] }

発達

ビルド: npm run build
開始: npm start
ウォッチモード: npm run dev

Here's a comprehensive status report of all Twitter tools: ## Working Tools (✓) 1. postTweet

ステータス: 正常に動作していますレスポンス: ツイートIDを返します最新のテスト: 成功

2. getTweetById

ステータス: 正常に動作していますレスポンス: 完全なツイートデータを返します最新のテスト: 成功

3. likeTweet & unlikeTweet

ステータス: 正常に動作しています応答: アクションの確認最新のテスト: 成功

4. retweet & undoRetweet

ステータス: 正常に動作しています応答: アクションの確認最新のテスト: 成功

5. replyToTweet

ステータス: 正常に動作していますレスポンス: 返信ツイートIDを返します最新のテスト: 成功

6. getUserInfo

ステータス: 正常に動作しています応答: ユーザープロファイルデータが完了しました最新のテスト: 成功

7. followUser & unfollowUser

ステータス: 正常に動作しています応答: アクションの確認最新のテスト: 成功

8. createList

ステータス: 正常に動作しています応答: リスト作成の確認最新のテスト: 成功

9. getUserLists

ステータス: 正常に動作しています応答: 所有リストとメンバーリストの両方を返します最新のテスト: 成功

## Tools with Issues (⚠️) 1. getUserTimeline

ステータス: エラー 400 エラー: 無効なリクエストパラメータ必要な修正: パラメータ検証

2. searchTweets

ステータス: エラー 400 エラー: 無効なリクエストパラメータ必要な修正: クエリパラメータのフォーマット

3. getLikedTweets

ステータス: エラー 400 エラー: 無効なリクエストパラメータ必要な修正: パラメータ検証

## Missing Tools (❌) - getHomeTimeline (not found in available tools) - getFollowers (not available) - getFollowing (not available) - getHashtagAnalytics (not available) ## Priority Fixes Needed 1. Parameter Validation: ```typescript // Implement for getUserTimeline, searchTweets, getLikedTweets interface TwitterParamValidator { validateTimelineParams(params: any): boolean; validateSearchParams(params: any): boolean; validateLikedTweetsParams(params: any): boolean; }

エラー処理:

// Enhance error handling for 400 errors interface TwitterErrorHandler { handle400Error(endpoint: string, params: any): void; logErrorDetails(error: any): void; suggestParameterFixes(params: any): string[]; }