Crazyrabbitltc MCP Twitter Server

🚀 Twitter MCP サーバ

Twitter API を統合するための Model Context Protocol サーバの実装です。このサーバを使用することで、Twitter 上の様々な操作を容易に行うことができます。

🚀 クイックスタート

以下の手順に従って、サーバをセットアップして起動します。

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. .env.example を .env にコピーし、Twitter API の認証情報を記入します。
4. プロジェクトをビルドします。

   npm run build
   

5. サーバを起動します。

   npm start
   

📦 インストール

環境変数

.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": "あなたのツイート内容"
}

• postTweetWithMedia：メディア添付のツイートを投稿します。

{
    "text": "あなたのツイート内容",
    "mediaPath": "メディアファイルのパス",
    "mediaType": "image/jpeg|image/png|image/gif|video/mp4",
    "altText": "（オプション）補助機能向けの説明テキスト"
}

• getTweetById：ID を指定してツイートを取得します。

{
    "id": "ツイートのID"
}

• deleteTweet：指定したツイートを削除します。

{
    "id": "ツイートのID"
}

ユーザ操作

• getUserProfile：現在のユーザプロファイル情報を取得します。

{
    "userId": "（オプション）対象ユーザの ID。未指定の場合は現在のユーザ"
}

• updateUserProfile：ユーザプロファイル情報を更新します。

{
    "name": "新しいユーザ名",
    "username": "新しいユーザ名",
    "bio": "新しい自己紹介",
    "location": "新しい場所情報",
    "url": "新しいURL"
}

フォローと被フォロー

• followUser：指定したユーザをフォローします。

{
    "userId": "フォローするユーザの ID"
}

• unfollowUser：指定したユーザのフォローを解除します。

{
    "userId": "フォローを解除するユーザの ID"
}

検索と分析

• searchTweets：条件に合致するツイートを検索します。

{
    "query": "検索キーワードまたはフレーズ",
    "maxResults": "（オプション）最大結果数。未指定の場合は 10"
}

• getTopicTrend：指定したトピックのトレンドデータを取得します。

{
    "topic": "調査するトピック名"
}

リスト管理

• createList：新しいリストを作成します。

{
    "listName": "新しいリストの名前",
    "mode": "public|private"  // リストのアクセス権限。public または private。未指定の場合は public
}

• addToList：指定したリストにユーザを追加します。

{
    "listId": "対象リストの ID",
    "userId": "追加するユーザの ID"
}

• removeFromList：指定したリストからユーザを削除します。

{
    "listId": "対象リストの ID",
    "userId": "削除するユーザの ID"
}

• getListMembers：指定したリストのすべてのメンバー情報を取得します。

{
    "listId": "対象リストの ID",
    "maxResults": "（オプション）最大結果数。未指定の場合は 10"
}

📚 ドキュメント

エラー処理

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

• パラメータが不足している場合：必要なパラメータが不足しています：parameter_name
• API エラーの場合：Twitter API から返されるエラーメッセージ
• リソースが見つからない場合：該当する「見つかりません」メッセージ

応答形式

すべての成功した応答は、以下の形式を使用します。

{
    "content": [
        {
            "type": "text",
            "text": "操作結果の情報"
        }
    ]
}

開発ガイド

• ビルド：npm run build
• 起動：npm start
• デバッグモード：npm run dev