Bluesky

🚀 BlueSky MCP サーバー

このサーバーは、BlueSky ソーシャルネットワークのデータにアクセスするための Model Context Protocol (MCP) サーバーです。公式 API を通じて、ユーザーのプロファイルやソーシャルグラフ情報を取得するための標準化されたインターフェースを提供します。

✨ 主な機能

• 詳細なユーザープロファイル情報の取得
• ユーザーのフォローリストの検索とページネーション機能
• 組み込みの認証処理とセッション管理
• 包括的なエラーハンドリング

📦 インストール

Claude Desktop

• MacOS システムでは：~/Library/Application\ 支持/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 .

実行

Claude クライアントと MCP ツールを接続し、json ファイルで設定した後、Claude はサーバーのプロファイルを表示できるはずです。

• サーバーを起動する際は、関連するドキュメントやガイドを参照してください。

💻 使用例

基本的な使用法

get-profile

入力

{
  "input": {
    "type": "string",
    "description": "The identifier for the user profile to retrieve.",
    "required": true,
    "content": {
      "schema": {
        "type": "string"
      }
    }
  },
  "output": {
    "type": "object",
    "description": "The retrieved user profile information.",
    "content": {
      "schema": {
        "$ref": "#/components/schemas/UserProfile"
      }
    }
  }
}

get-follows

入力

{
  "input": {
    "type": "string",
    "description": "The identifier for the user whose follows we want to retrieve.",
    "required": true,
    "content": {
      "schema": {
        "type": "string"
      }
    }
  },
  "output": {
    "type": "object",
    "description": "The retrieved follow information.",
    "content": {
      "schema": {
        "$ref": "#/components/schemas/FollowInformation"
      }
    }
  }
}

🔧 技術詳細

このサーバーは、以下のエラー状況を処理できます。

• 無効または形式が正しくない入力
• 制限を超えたリクエスト
• ネットワーク接続問題
• 認証失敗

🔑 認証

このサーバーを使用するには、以下の手順が必要です。

1. 環境変数 BLUESKY_IDENTIFIER と BLUESKY_APP_PASSWORD を設定する
2. これらの資格情報の有効性とセキュリティを確保する

📄 ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。これは、MIT ライセンスの条項と条件に従い、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。

コントリビューションを歓迎します！自由にプルリクエストを送信してください。

何か問題がある場合やさらなる支援が必要な場合は、ドキュメントを参照するか、メンテナンスチームに連絡してください。