Bluesky MCP Server

🚀 蓝天 MCP サーバー

このサーバーは、蓝天社交ネットワーク（BlueSky）の公式 API を通じてデータへのアクセスを提供するモデルコンテキストプロトコル (MCP) サーバーです。ユーザープロファイルや社交関係情報の取得を行う標準インターフェースを実装しています。

✨ 主な機能

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

📦 インストール

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 クライアントに接続し、JSON ファイルで設定した後、以下のコマンドを実行できます。

uv run main:app --reload

http://localhost:8000/ にアクセスして、アプリを使用します。

💻 使用例

基本的な使用法

get - profile

ユーザープロファイル情報を取得します。

{
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "+1234567890"
}

{
  "user_id": "12345",
  "display_name": "John Doe",
  "bio": "Tech enthusiast | OpenAI Developer",
  "created_at": "2023-10-10T12:00:00Z"
}

get - follows

ユーザーのフォローリストを取得します（ページング対応）。

{
  "user_id": "12345",
  "page": 1,
  "per_page": 10
}

{
  "users": [
    {
      "user_id": "67890",
      "display_name": "Jane Smith",
      "bio": "AI Engineer at XYZ Corp"
    },
    // 他のユーザー...
  ],
  "total_pages": 5,
  "current_page": 1
}

🔧 技術詳細

エラー処理

• 401 Unauthorized：認証に失敗しました。API キーが正しいか確認してください。
• 404 Not Found：要求されたリソースが見つかりません。パスとパラメータが正しいことを確認してください。
• 500 Internal Server Error：サーバー内部エラーです。管理者に連絡してください。

前提条件

• Python と pip をインストールしてください。
• 必要な依存関係をインストールします。

pip install fastapi uvicorn python-multipart

認証情報

以下の機密情報を漏洩しないでください。

• BLUESKY_IDENTIFIER：ユーザー識別子。
• BLUESKY_APP_PASSWORD：アプリパスワード。

🤝 貢献

Pull Request の投稿を歓迎します！

📄 ライセンス

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