Bluesky MCP Server

Bluesky MCP Server

Model Context Protocol サーバーで、Bluesky に接続し、ATProtocol とやり取りするためのツールを提供します。

この MCP サーバーを使うと、さまざまな Bluesky / ATProtocol API エンドポイントのコンテキストを、LLM ベースのアプリケーションのコンテキストウィンドウに直接取り込めます。たとえば、このサーバーを Claude Desktop に追加すれば、自然言語で操作できる Bluesky クライアントとして利用できます。

機能とツール

• よく使われる Bluesky の機能を自然言語で利用できます（例：「David Roberts の最近の投稿を取得して」）
• フィードを取得して分析できます（「シアトルについてのフィードを探して、みんなが何について話しているか教えて」）
• フォロワーのリストを取得して分析できます（「Mark Cuban はどのようなアカウントをフォローしていますか？ 詳しいレポートを作成して」）
• LLM を使って投稿を書き、代わりに投稿できます 😱（「今日の私の地域の天気について俳句を書いて、bluesky に投稿して」）
• フィード、投稿、人々を検索できます（「#teslatakedown についての投稿を探して、最近の出来事を要約して」）
• あなたをフォローしている人を分析できます（「Bluesky で私をフォローしているのは誰ですか？ レポートを作成して」）

現在提供されているツールの一覧は次のとおりです。

• get-pinned-feeds：認証済みユーザーの設定にある「ピン留め」項目をすべて返します。
• get-timeline-posts：認証済みユーザーのホームタイムラインから投稿を返します
• get-feed-posts：指定したフィードから投稿を返します
• get-list-posts：指定したリストから投稿を返します
• get-user-posts：指定したユーザーの投稿を返します
• get-profile：指定したユーザーのプロフィール情報を返します
• get-follows：アカウントがフォローしているユーザーの一覧を返します
• get-followers：アカウントをフォローしているユーザーの一覧を返します
• get-liked-posts：認証済みユーザーが最近「いいね」した投稿を返します
• get-trends：Bluesky で現在トレンドになっているトピックと投稿数を返します
• get-post-thread：特定の投稿について、すべての返信とコンテキストを含む会話スレッド全体を返します
• convert-url-to-uri：Bluesky の Web URL を、ほかのツールで使用できる AT URI 形式に変換します
• search-posts：指定したクエリに一致する投稿を返します。人気順または新着順を指定できます
• search-people：指定した検索クエリに一致するユーザーを返します
• search-feeds：指定したクエリに一致するフィードを返します
• like-post：特定の URI の投稿に「いいね」します
• create-post：投稿を公開します
• follow-user：特定のユーザーをフォローします

ヒント：

• 検索結果、タイムライン、リスト、フィード、プロフィールにある投稿を、期間を指定して尋ねることができます。たとえば、「過去 3 日間のタイムラインの投稿を要約して」や「今週、みんなが話題にしていた最も興味深い記事を探して」などです
• 思い切った質問をしてみましょう：「過去 24 時間に私のタイムラインで見た投稿の中で、最も面白い／常軌を逸した／奇妙な／ふざけた投稿はどれですか？」
• 自分について知りましょう：「私が「いいね」した投稿を分析して、私が何に興味を持っているか教えてください。見つかったことについて興味深い事実を 3 つ挙げ、それが bluesky での私の性格とどう関係しているか教えてください」または「bluesky で私をフォローしているのは誰ですか？ 詳細なレポートを作成して」

インストール

Smithery 経由でインストールする

Smithery 経由で Bluesky MCP Server を Claude Desktop に自動インストールするには：

npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claude

手動でインストールする

まずこのリポジトリをクローンし、依存関係をインストールしてサーバーをビルドします。

# Install dependencies
pnpm install

# Build the project
pnpm run build

MCP Inspector でテストする

優れた MCP Inspector を使うと、LLM に接続せずに Bluesky ツールを直接テストできます。まずサーバーをビルドしてから、次のコマンドを実行してください。

npx @modelcontextprotocol/inspector node build/src/index.js

ターミナルに表示されたローカル URL にアクセスし、左側のパネルから BLUESKY_IDENTIFIER、BLUESKY_APP_PASSWORD、BLUESKY_SERVICE_URL の環境変数を設定します。get-timeline ツールを試して、ホームタイムラインの最新の投稿を確認してください。

MCP クライアントの設定

お好みのクライアントで MCP を設定する手順に従ってください。たとえば、デスクトップ版 Claude から Bluesky に接続するには、以下を claude_desktop_config.json の bluesky セクションに追加します。

{
    "mcpServers": {
      "bluesky": {
        "command": "node",
        "args": ["/path/to/bsky-mcp-server/build/src/index.js"],
        "env": {
            "BLUESKY_IDENTIFIER": "your-bluesky-handle",
            "BLUESKY_APP_PASSWORD": "your-app-password",
            "BLUESKY_SERVICE_URL": "https://bsky.social"
          }
      }
    }
  }

Claude のデスクトップ版で MCP サーバーを実行する方法の詳細については、https://modelcontextprotocol.io/quickstart/user をご覧ください。

アプリパスワードの作成

この MCP サーバーを使用するには、Bluesky アカウント用のアプリパスワードを作成する必要があります。

1. Bluesky にログインします
2. Settings > App Passwords に移動します
3. この連携専用の新しいアプリパスワードを作成します
4. BLUESKY_APP_PASSWORD 環境変数を使ってアプリパスワードを設定します

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

• このサーバーはセッション情報をメモリ内にのみ保存し、MCP クライアントと共有しません。
• MCP クライアントはツールにのみアクセスでき、認証情報やアプリパスワードにはアクセスできません

ライセンス

MIT