Brianellin Bsky MCP Server

🚀 ブルースカイ MCP サーバー

このサーバーは Model Context Protocol をベースに構築されており、Bluesky に接続し、ATProtocol とのインタラクションを可能にするツールを提供します。

この MCP サーバーをあなたの LLM ベースのアプリケーションに統合することで、Bluesky / ATProtocol API エンドポイントから直接コンテキスト情報を取得できます。例えば、Claude Desktop にこのサーバーを追加し、自然言語で操作する Bluesky クライアントとして利用できます。

✨ 主な機能

• 自然言語で一般的な Bluesky 機能と対話（例：「David Roberts の最近の投稿を取得」）
• フィードの検索と分析（「シアトルに関するフィードを見つけ、人々が何を話しているか教えて」）
• フォロワーリストの検索と分析（「Mark Cuban がフォローしているアカウントのタイプを教えて、詳細なレポートを作成して」）
• LLM を使って投稿を作成し、自動的に投稿（「今日の天気に関する俳句を書き、Bluesky に投稿」）
• フィード、投稿、ユーザーの検索（「#teslatakedown に関する投稿を検索し、最近の出来事を要約して」）

提供されるツール

• get-pinned-feeds：認証済みユーザーの「固定」項目の集合を返します。
• get-timeline-posts：認証済みユーザーのホームタイムライン上の投稿を返します。
• get-feed-posts：指定されたフィード内の投稿を返します。
• get-list-posts：指定されたリスト内の投稿を返します。
• get-user-posts：指定されたユーザーの投稿を返します。
• get-profile：指定されたユーザーのプロファイル情報を返します。
• get-follows：現在のユーザーがフォローしているユーザーのセットを返します。
• get-liked-posts：認証済みユーザーが最近いいねした投稿を返します。
• get-trends：Bluesky 上の現在のトレンドトピックとその投稿数を返します。
• search-posts：クエリに基づいて投稿を返し、最新または最も人気のあるものを選択できます。
• search-people：クエリに基づいてユーザーを返します。
• search-feeds：クエリに基づいてフィードを返します。
• like-post：特定の URI を使用して投稿にいいねを付けます。
• create-post：投稿を作成します。
• follow-user：指定されたユーザーをフォローします。

📦 インストール

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

# 依存関係のインストール
pnpm install

# プロジェクトのビルド
pnpm run build

MCP Inspector を使用したテスト

LLM に接続することなく、MCP Inspector を使用して Bluesky ツールを直接テストできます。まずサーバーをビルドし、次のコマンドを実行します。

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

ターミナルで提供されるローカル URL にアクセスし、左側のパネルから BLUESKY_IDENTIFIER、BLUESKY_APP_PASSWORD、BLUESKY_SERVICE_URL 環境変数を設定します。get-timeline ツールを使用して、タイムライン上の最近の投稿を確認してみてください。

💻 MCP クライアントの設定

好みのクライアントと互換性のある MCP を設定するには、以下の手順に従います。例えば、Claude for desktop で Bluesky に接続するには、claude_desktop_config.json の bluesky セクションに以下の内容を追加します。

{
    "mcpServers": {
      "bluesky": {
        "command": "node",
        "args": ["/path/to/bsky-mcp-server/build/src/index.js"],
        "env": {
            "BLUESKY_IDENTIFIER": "あなたの Bluesky ユーザー名",
            "BLUESKY_APP_PASSWORD": "あなたの Bluesky アプリパスワード",
            "BLUESKY_SERVICE_URL": "Bluesky サービス URL"
        }
      }
    }
}

アプリパスワードの作成

1. Bluesky アカウントにログインします。
2. 設定 を開きます。
3. 「アプリ」タブを選択します。
4. 「新しいアプリを作成」ボタンをクリックします。
5. アプリの詳細を入力して保存すると、システムがアプリパスワードを生成します。

📄 ライセンス

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

⚠️ 重要提示

このサーバーはセッション情報をメモリ内にのみ保持し、ローカルディスクまたはリモートサービスには永続化しません。