Agent Twitter Client MCP

🚀 代理推特クライアント - MCP インストールガイド

このプロジェクトは、Twitterクライアントの代理サービスを提供するもので、Node.js環境で動作します。以下にインストール手順や設定方法を詳しく説明します。

✨ 主な機能

• Node.js 18+ と npm を利用したインストールと実行が可能です。
• 環境変数を使った設定が容易で、ログレベルや実行環境を柔軟に変更できます。
• Docker や Docker Compose を用いたデプロイが可能で、ログの永続化もサポートしています。

📦 インストール

前提条件

• Node.js 18+ バージョン
• npm パッケージマネージャー

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/ryanmac/agent-twitter-client-mcp.git
cd agent-twitter-client-mcp

2. 依存関係をインストールします。

npm install

3. .env 設定ファイルを作成します。

AUTH_METHOD=cookies
TWITTER_COOKIES=["cookie1=value1", "cookie2=value2"]

4. プロジェクトをビルドします。

npm run build

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

npm start

📚 ドキュメント

環境変数設定

認証関連の変数以外に、以下の環境変数を設定できます。

• LOG_LEVEL：ログレベルを設定します（error、warn、info、debug）
• NODE_ENV：実行環境を設定します（development、production）

Docker デプロイ

直接 Docker を使用する場合

# Docker イメージをビルドします。
docker build -t agent-twitter-client-mcp .

# コンテナを起動し、ポートをマッピングします。
docker run -p 3000:3000 \
  -e AUTH_METHOD=cookies \
  -e TWITTER_COOKIES='["auth_token=YOUR_AUTH_TOKEN; Domain=.twitter.com", "ct0=YOUR_CT0_VALUE; Domain=.twitter.com"]' \
  agent-twitter-client-mcp

Docker Compose を使用する場合

1. Twitter の認証情報を含む .env ファイルを作成します。
2. サービスを起動します。

# サービスを起動します。
docker-compose up -d

# ログを確認します。
docker-compose logs -f

# サービスを停止します。
docker-compose down

Docker 環境変数の設定方法

環境変数は以下の方法で渡すことができます。

1. docker-compose.yml ファイルに設定する（既に設定済み）
2. .env ファイルを使用する（docker-compose での使用が推奨）
3. docker run コマンドで直接指定する（上記の例を参照）

ログの永続化

Docker Compose の設定にはログボリュームのマウントが含まれています。

volumes:
  - ./logs:/app/logs

これにより、ログはプロジェクトディレクトリ内の logs フォルダに保存されます。

セキュリティに関する注意事項

• 認証情報の保管：認証情報を安全に保管し、環境変数またはセキュリティボールトを使用することをおすすめします。
• レート制限：Twitter API の乱用を防ぐために、レート制限を実装してください。
• 内容の検証：投稿する前にすべての内容を検証し、悪意のある使用を防いでください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。