Skip to main content
Glama
enesjakozh
berlinbra

BlueSky MCP Server

by berlinbra
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

BlueSky MCP サーバー

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

特徴

  • 詳細なユーザープロフィール情報を取得する

  • ページ区切りでユーザーのフォローリストを取得する

  • 組み込みの認証処理とセッション管理

  • 包括的なエラー処理

Related MCP server: ETHID MCP Server

インストール

クロードデスクトップ

  • 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 サーバーを使用するには、次のことが必要です。

  1. BlueSkyアカウントをお持ちでない場合は作成してください

  2. BlueSkyアカウント設定でアプリパスワードを生成する

  3. 次の環境変数を設定します。

    • BLUESKY_IDENTIFIER : BlueSky ハンドル (例: "username.bsky.social")

    • BLUESKY_APP_PASSWORD : 生成されたアプリパスワード

貢献

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

ライセンス

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

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
B
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • X MCP Server

    krishna-paulraj
    F
    license
    B
    quality
    D
    maintenance
    Enables users to interact with X (Twitter) through the X API. Supports posting tweets, retrieving user timelines, searching tweets, and replying to tweets with comprehensive error handling.
    3
    16

  • mcpbluesky

    awaku7
    A
    license
    B
    quality
    D
    maintenance
    An MCP server that enables users to interact with the Bluesky social network through comprehensive read and write API tools, including session management and timeline navigation. It also features a Jetstream-powered local SQLite database for indexing and searching Japanese posts.
    36
    2
    MIT

  • AT Protocol MCP Server

    cameronrye
    A
    license
    A
    quality
    A
    maintenance
    Enables LLMs to interact with the AT Protocol ecosystem, including Bluesky, through natural language. Supports public data access without authentication and full write operations with authentication.
    51
    51
    8
    MIT

View all related MCP servers

Related MCP Connectors

  • uluesky

    Bluesky MCP — wraps the AT Protocol API

  • x-twitter-profile-tweets

    X (Twitter) profiles, tweets and single-tweet lookup by handle or URL. No login. Pay per result.

  • HasData Instagram

    Public Instagram profiles and post feeds by handle, with hashtags and mentions parsed.

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/berlinbra/BlueSky-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server