remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to BlueSky social network data through its official API, with tools for retrieving user profiles, following/follower lists, accessing personal feeds, searching posts and profiles, and viewing liked content.

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ファイルをご覧ください。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

公式 API を介して BlueSky ソーシャルネットワークとのやり取りを容易にし、ユーザーが認証およびエラー処理機能を使用して詳細なユーザープロファイルとフォローリストを取得できるようにします。

Related Resources

Reddit Discussion about this server

BlueSky MCP Server