X Post MCP

🚀 🐦 X-Post MCP 🚀

このツールは、強力な統合ツールで、AIモデルがModel Context Protocol (MCP)を通じて直接X（旧Twitter）にコンテンツを投稿できるようにします 🤖✨

🚀 クイックスタート

X-Post MCPは、AIモデルがX（旧Twitter）プラットフォーム上で投稿を作成して公開できるクライアント - サーバーアプリケーションです。Model Context Protocolを利用して、AIモデルとXプラットフォーム間のシームレスな統合を実現します。

✨ 主な機能

• 🔄 X（Twitter）APIとのスムーズな統合
• 🧠 GoogleのGeminiモデルを使用したAIによる投稿生成
• 🛠️ X投稿機能を提供するMCPサーバーエンドポイント
• 💬 テストとデモ用の対話型チャットインターフェイス
• 🔒 API資格情報の安全な処理
• ✂️ Xの文字制限を超える投稿の自動切り捨て

📦 インストール

1. 依存関係のインストール

サーバー側のインストール

cd server
npm install express @types/express

クライアント側のインストール

cd client
npm install @tensorflow/tfjs @tensorflow-models/generative-ai

2. 環境変数の設定

サーバーのルートディレクトリに.envファイルを作成し、以下の内容を追加します。

TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_BEARER_TOKEN=your_bearer_token
GEMINI_API_KEY=your_gemini_api_key

3. サービスの起動

サーバーの起動

cd server
npm run dev

サービスは http://localhost:3001 で実行されます。

クライアントの起動

cd client
npm run index.ts

💻 使用例

基本的な使用法

你：发布一条关于今天美好天气的推文

AIモデルはGeminiを使用してコンテンツを生成し、MCPツールを通じてXプラットフォームに送信します。

高度な使用法

投稿ルールのカスタマイズ

server/src/tools/createPost.ts ファイルで、必要に応じて投稿ロジックをカスタマイズできます。

export async function createPost(context: Context, args: string[]) {
  const message = await gemini.generate(args.join(' '));
  return { status: 'success', message };
}

AI機能の拡張

client/src/models/gemini.ts ファイルを置き換えたり拡張したりすることで、より多くのAIモデルをサポートできます。

🔧 技術詳細

• Bun：高速なワンストップJavaScriptランタイム
• TypeScript：型安全なJavaScript
• Express：効率的なWebアプリケーションフレームワーク
• Server-Sent Events (SSE)：リアルタイム通信プロトコル

📚 ドキュメント

プロジェクトアーキテクチャ

• サーバー側：Expressフレームワークをベースに、MCPプロトコルをサポートし、Server-Sent Events (SSE) を通じて長時間ポーリング通信を実現します。
• クライアント側：MCPサーバーに接続し、AIモデルとやり取りするためのインターフェイスツールです。

核心機能

1. AIコンテンツ生成：Google Geminiモデルを利用して高品質なテキストを生成します。
2. Xプラットフォームへの投稿：Twitter APIを通じてコンテンツをターゲットアカウントに投稿します。
3. リアルタイム通信：SSEを使用してクライアントとサーバー間の双方向データフローを実現します。

🤝 貢献ガイド

貢献を歓迎します！以下の手順でPRを提出してください。

1. リポジトリをForkする
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ファイルを参照してください。

🙏 謝辞

以下のプロジェクトの貢献に感謝します。

• Model Context Protocol：標準化されたAIコンテキストプロトコルを提供します。
• Twitter API v2：Xプラットフォームの統合をサポートします。
• Google Gemini：強力なAI機能を提供します。