BlueSky MCP サーバー

BlueSkyソーシャルネットワークデータへのアクセスを公式APIを通じて提供するモデルコンテキストプロトコル（MCP）サーバー。ユーザープロファイルとソーシャルグラフ情報を取得するための標準化されたインターフェースを実装しています。

特徴

詳細なユーザープロフィール情報を取得する
ページ区切りでユーザーのフォローリストを取得する
組み込みの認証処理とセッション管理
包括的なエラー処理

インストール

クロードデスクトップ

MacOSの場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

    "mcpServers": {
        "bluesky-mcp": {
            "command": "uv",
            "args": [
            "--directory",
            "C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp\\bluesky-mcp",
            "run",
            "src/bluesky_mcp/server.py"
            ],
            "env": {
                "BLUESKY_IDENTIFIER": "your.handle.bsky.social",
                "BLUESKY_APP_PASSWORD": "your-app-password"
            }
        }
    }

ローカルで実行

ライブラリをインストールする

uv pip install -e .

ランニング

json ファイル経由で Claude クライアントを MCP ツールに接続し、パッケージをインストールすると、Claude はサーバーの mcp ツールを確認できるようになります。

以下のコマンドでサーバーを自分で実行できます: bluesky_mcp リポジトリ内:

uv run src/bluesky_mcp/server.py

*サーバーと一緒にサーバーインスペクターを実行する場合:

npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp run src/bluesky_mcp/server.py

利用可能なツール

サーバーは次の 2 つのツールを実装します。

get-profile : BlueSky ユーザーの詳細なプロフィール情報を取得する
get-follows : 指定されたユーザーがフォローしているアカウントのリストを取得する

プロファイル取得

指定された BlueSky ユーザーの詳細なプロフィール情報を取得します。

入力スキーマ:

{
    "handle": {
        "type": "string",
        "description": "The user's handle (e.g., 'alice.bsky.social')"
    }
}

応答例:

Profile information for alice.bsky.social:

Handle: alice.bsky.social
Display Name: Alice
Description: Just a BlueSky user sharing thoughts
Followers: 1234
Following: 567
Posts: 789

フォローを獲得する

ページ区切りをサポートし、指定されたユーザーがフォローしているアカウントのリストを取得します。

入力スキーマ:

{
    "actor": {
        "type": "string",
        "description": "The user's handle (e.g., 'alice.bsky.social')"
    },
    "limit": {
        "type": "integer",
        "description": "Maximum number of results to return",
        "default": 50,
        "minimum": 1,
        "maximum": 100
    },
    "cursor": {
        "type": "string",
        "description": "Pagination cursor",
        "optional": true
    }
}

応答例:

Follows for alice.bsky.social:

Follows:
Handle: bob.bsky.social
Display Name: Bob
---
Handle: carol.bsky.social
Display Name: Carol
---
Handle: dave.bsky.social
Display Name: Dave
---

More results available. Use cursor: bafygeia...

エラー処理

サーバーには、さまざまなシナリオに対応する包括的なエラー処理機能が含まれています。

認証失敗
レート制限
ネットワーク接続の問題
無効なパラメータ
タイムアウト処理
不正な応答

エラーメッセージは、明確で人間が読める形式で返されます。

前提条件

Python 3.12以上
httpx
マクピー

認証

この MCP サーバーを使用するには、次のことが必要です。

BlueSkyアカウントをお持ちでない場合は作成してください
BlueSkyアカウント設定でアプリパスワードを生成する
次の環境変数を設定します。
- BLUESKY_IDENTIFIER : BlueSky ハンドル (例: "username.bsky.social")
- BLUESKY_APP_PASSWORD : 生成されたアプリパスワード

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

BlueSky MCP Server

Integrations