Bluesky Social MCP

🚀 Bluesky Social MCP

Bluesky Social MCPは、atprotoクライアントを介してBlueskyソーシャルネットワークとやり取りするためのMCPサーバーです。このアプリケーションを使用することで、Blueskyの様々な機能を利用できます。

:wave: このMCPを実行する際に問題が発生した場合は、Issueを立ててください。私は迅速に修正を行うことができるはずです。

🚀 クイックスタート

Blueskyのアプリパスワードは、以下のURLから取得できます。 https://bsky.app/settings/app-passwords

次の内容をMCPの設定ファイルに追加してください（バージョンは固定されています）。

{
  "mcpServers": {
    "bluesky-social": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1", "bluesky-social-mcp"],
      "env": {
        "BLUESKY_IDENTIFIER": "your-handle.bsky.social",
        "BLUESKY_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

⚠️ 重要提示

セキュリティ上の理由から、バージョンを固定しておき、設定を手動で変更してバージョンを更新することをおすすめします。

✨ 主な機能

ツールの状態

すべてのツールが実装され、テストされています ✅

認証とセットアップ

• ✅ check_auth_status - 現在のセッションが認証されているか確認します。

プロファイル操作

• ✅ get_profile - ユーザープロファイルを取得します（クライアントメソッド: get_profile）。
• ✅ get_follows - アカウントがフォローしているユーザーを取得します（クライアントメソッド: get_follows）。
• ✅ get_followers - アカウントをフォローしているユーザーを取得します（クライアントメソッド: get_followers）。
• ✅ follow_user - ユーザーをフォローします（クライアントメソッド: follow）。
• ✅ unfollow_user - ユーザーのフォローを解除します（クライアントメソッド: unfollow）。
• ✅ mute_user - ユーザーをミュートします（クライアントメソッド: mute）。
• ✅ unmute_user - ユーザーのミュートを解除します（クライアントメソッド: unmute）。
• ✅ resolve_handle - ハンドルをDIDに解決します（クライアントメソッド: resolve_handle）。

フィード操作

• ✅ get_timeline - ホームタイムラインの投稿を取得します（クライアントメソッド: get_timeline）。
• ✅ get_author_feed - 特定のユーザーの投稿を取得します（クライアントメソッド: get_author_feed）。
• ✅ get_post_thread - 完全な会話スレッドを取得します（クライアントメソッド: get_post_thread）。

投稿インタラクション

• ✅ like_post - 投稿にいいねを付けます（クライアントメソッド: like）。
• ✅ unlike_post - 投稿のいいねを取り消します（クライアントメソッド: unlike）。
• ✅ get_likes - 投稿のいいねを取得します（クライアントメソッド: get_likes）。
• ✅ repost - 投稿を再投稿します（クライアントメソッド: repost）。
• ✅ unrepost - 再投稿を取り消します（クライアントメソッド: unrepost）。
• ✅ get_reposted_by - 投稿を再投稿したユーザーを取得します（クライアントメソッド: get_reposted_by）。

投稿の作成と管理

• ✅ send_post - 新しいテキスト投稿を作成します（クライアントメソッド: send_post）。
• ✅ send_image - 単一の画像付きの投稿を送信します（クライアントメソッド: send_image）。
• ✅ send_images - 複数の画像付きの投稿を送信します（クライアントメソッド: send_images）。
• ✅ send_video - 動画付きの投稿を送信します（クライアントメソッド: send_video）。
• ✅ delete_post - 投稿を削除します（クライアントメソッド: delete_post）。
• ✅ get_post - 特定の投稿を取得します（クライアントメソッド: get_post）。
• ✅ get_posts - 複数の投稿を取得します（クライアントメソッド: get_posts）。

ローカルクローンから実行する

{
    "mcpServers": {
        "bluesky-social": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/bluesky-social-mcp",
                "run",
                "server.py"
            ],
            "env": {
                "BLUESKY_IDENTIFIER": "user-name.bsky.social‬",
                "BLUESKY_APP_PASSWORD": "app-password-here"
            }
        }
    }
}

📦 インストール

開発環境のセットアップ

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

   uv sync
   

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

   uv run bluesky-social-mcp
   

MCPインスペクターでデバッグする

mcp dev server.py
mcp dev server.py --with-editable .

テストを実行する

• 実際のBlueskyサーバーに対してテストを実行します。
• テストでは、BLUESKY_IDENTIFIER と BLUESKY_APP_PASSWORD の環境変数が使用されます。

uv run pytest