Warpcast

🚀 Warpcast MCP サーバー

Warpcastを統合するためのモデルコンテキストプロトコル（MCP）サーバーです。Claudeを使用してWarpcastアカウントとやり取りできます。

✨ 主な機能

• Warpcastアカウントにブロードキャストを投稿する
• Warpcastからブロードキャストを読み取る
• キーワードまたはハッシュタグでブロードキャストを検索する
• チャンネルを閲覧してインタラクションする
• チャンネルをフォロー/フォロー解除する
• 人気のブロードキャストを取得する

📦 インストール

1. このリポジトリをクローンする

   git clone https://github.com/zhangzhongnan928/mcp-warpcast-server.git
   cd mcp-warpcast-server
   

2. 依存関係をインストールする

   npm install
   

3. APIキーを生成し、認証を設定する

   このMCPサーバーは、必要なEd25519キーペアを生成するための補助スクリプトを提供します。

   npm run generate-keys
   

   次に、config.jsonファイルを開き、以下の環境変数を.envファイルに追加します。

   _fid=your_farcaster_id
   _public_key=あなたの公開鍵
   _private_key=あなたの秘密鍵
   

4. サーバーを起動する

   npm start
   

💻 使用例

基本的な使用法

設定が完了したら、Claudeに以下の操作を実行させることができます。

• "[トピック]に関するブロードキャストを投稿する"
• "ユーザー[ユーザー名]の最新のブロードキャストを表示する"
• "[トピック]に関するブロードキャストを検索する"
• "Warpcast上の人気のブロードキャストを表示する"
• "人気のチャンネルを表示する"
• "[チャンネル]チャンネルのブロードキャストを取得する"

高度な使用法

このMCPサーバーは、Claudeが使用できる複数のツールを提供します。

1. post-cast：Warpcast上に新しいブロードキャストを作成する（最大320文字）
2. get-user-casts：特定のユーザーの最近のブロードキャストを取得する
3. search-casts：キーワードまたはフレーズでブロードキャストを検索する
4. get-trending-casts：現在人気のブロードキャストを取得する
5. get-all-channels：Warpcast上のすべてのチャンネルをリストする
6. get-channel：特定のチャンネルの情報を取得する
7. get-channel-casts：特定のチャンネルのブロードキャストを取得する
8. follow-channel：チャンネルをフォローする
9. unfollow-channel：チャンネルのフォローを解除する

📚 ドキュメント

注意事項

このサーバーはWarpcastのアプリケーションキー認証方法を使用しており、FarcasterアカウントにEd25519キーペアを登録する必要があります。認証フローは以下の通りです。

1. FIDと公開鍵を含むヘッダーを作成する
2. 有効期限付きのペイロードを作成する
3. 秘密鍵を使用してヘッダーとペイロードに署名する
4. 生成されたトークンを使用してAPI呼び出しを行う

本番環境では、公式のFarcaster SDKを使用して認証トークンを生成することをお勧めします。

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

• 秘密鍵を必ず安全に保管し、決して漏洩させないでください。
• 定期的にキーをローテーションすることを検討してください。
• サーバーは認証エラーを記録してデバッグを支援します。

トラブルシューティング

問題が発生した場合は、以下のことを確認してください。

1. 環境変数が正しく設定されていることを確認する
2. キーがFarcasterアカウントに正常に登録されていることを確認する
3. Claude for Desktopのログにエラーがないか確認する
4. Warpcastアカウントに必要な権限があることを確認する

📄 ライセンス

MIT