🐦 X-Post MCP 🚀

🐦 X-Post MCP 🚀

Model Context Protocol（MCP）を使用して、AI モデルから X（旧 Twitter）に直接投稿できる強力な統合機能です 🤖✨

📋 概要

X-Post MCP は、標準化されたインターフェースを通じて、AI モデルが X（旧 Twitter）への投稿を作成・公開できるクライアント・サーバーアプリケーションです。Model Context Protocol を活用し、AI モデルと X プラットフォームをシームレスに統合します。

✨ 機能

• 🔄 X（Twitter）API とのシームレスな統合
• 🧠 Google の Gemini モデルを使用した AI による投稿作成
• 🛠️ X への投稿機能をツールとして公開する MCP サーバー
• 💬 テストやデモに使えるインタラクティブなチャットインターフェース
• 🔒 API 認証情報を安全に管理
• ✂️ X の文字数制限を超える投稿を自動的に切り詰め

🛠️ 技術

• Bun: 高速なオールインワン JavaScript ランタイム
• TypeScript: 型安全な JavaScript
• Express: Node.js 向け Web フレームワーク
• Model Context Protocol (MCP): AI コンテキストの標準化プロトコル
• Twitter API v2: X プラットフォーム API
• Google Gemini: Google の生成 AI モデル

📦 インストール

前提条件

• Bun v1.2.5 以降
• X（Twitter）API 認証情報
• Google Gemini API キー

サーバーのセットアップ

# Clone the repository
git clone https://github.com/subhadeeproy3902/x-post-mcp.git
cd x-post-mcp

# Install server dependencies
cd server
bun install

クライアントのセットアップ

# From the project root
cd client
bun install

⚙️ 設定

X（Twitter）API 認証情報の取得

1. 開発者アカウントを作成する:

   • X Developer Portal にアクセスします
   • X アカウントでサインインするか、新しいアカウントを作成します
   • まだ開発者アカウントをお持ちでない場合は、開発者アカウントを申請します

2. プロジェクトとアプリを作成する:

   • 承認されたら、Developer Portal で新しいプロジェクトを作成します
   • プロジェクト内で新しいアプリを作成します
   • アプリに名前と説明を設定します

3. アプリの権限を設定する:

   • アプリの設定で、「User authentication settings」セクションに移動します
   • 設定を編集し、OAuth 1.0a を有効にします
   • アプリの権限を読み取りと書き込み、およびダイレクトメッセージに設定します
   • 変更を保存します

4. アクセストークンを生成する:

   • 「Keys and Tokens」タブに移動します
   • 「Consumer Keys」（API Key と Secret）を生成します
   • アカウント用の「Access Token and Secret」を生成します
   • 設定に必要となるため、4 つの値すべてを必ず保存してください

⚠️ 重要: API キーとトークンは安全に保管し、公開リポジトリにコミットしないでください。

サーバーの環境変数

server ディレクトリに、次の変数を含む .env ファイルを作成します。

# X (Twitter) API Credentials
TWITTER_API_KEY=your_twitter_api_key
TWITTER_API_SECRET=your_twitter_api_secret
TWITTER_ACCESS_TOKEN=your_twitter_access_token
TWITTER_ACCESS_SECRET=your_twitter_access_secret

Google Gemini API キーの取得

1. Google AI Studio アカウントを作成する:

   • Google AI Studio にアクセスします
   • Google アカウントでサインインします

2. API キーを取得する:

   • API Keys section に移動します
   • 「Create API Key」をクリックします
   • 新しい API キーをコピーします

⚠️ 重要: API キーは安全に保管し、公開リポジトリにコミットしないでください。

クライアントの環境変数

client ディレクトリに、次の変数を含む .env ファイルを作成します。

# Google Gemini API Key
GEMINI_API_KEY=your_gemini_api_key

🚀 使い方

サーバーの起動

cd server
bun run dev

サーバーは http://localhost:3001 で起動します。

クライアントの起動

cd client
bun run index.ts

クライアントはサーバーに接続し、AI モデルとやり取りして X への投稿を指示できるインタラクティブなチャットインターフェースを提供します。

コマンドの例

クライアントの実行後、AI モデルとやり取りできます。

You: Post a tweet about the beautiful weather today

AI は Gemini モデルを使って投稿を生成し、その後 MCP ツールを使って X に投稿します。

🏗️ アーキテクチャ

サーバー

サーバーコンポーネントは Express で構築され、Model Context Protocol を実装しています。X への投稿に使用できる createPost というツールを公開しています。サーバーはクライアントとの通信に Server-Sent Events（SSE）を使用します。

クライアント

クライアントコンポーネントは MCP サーバーに接続し、Google の Gemini AI モデルとやり取りするためのインターフェースを提供します。ユーザーのリクエストを AI が生成するコンテンツに変換し、サーバーのツールを呼び出して X に投稿できます。

🤝 コントリビューション

コントリビューションを歓迎します。Pull Request をお気軽にお送りください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. Pull Request を作成します

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については LICENSE ファイルをご覧ください。

🙏 謝辞

• 標準化された AI コンテキストプロトコルを提供する Model Context Protocol
• X プラットフォームとの連携を可能にする Twitter API v2
• AI 機能を提供する Google Gemini