Bluesky Context Server

Bluesky コンテキストサーバー

Claude Desktop などの MCP クライアントが Bluesky とやり取りできるようにする、Model Context Protocol（MCP）サーバーです。プロフィールの確認、投稿の検索、タイムラインの取得などを、AI アシスタントから直接行えます。

前提条件

• ランタイム：Bun または Node.js v22.6.0 以降
• Bluesky アカウント

セットアップ

1. Bluesky の認証情報を取得する

Bluesky アカウントから、次の 2 つの情報が必要です。

BLUESKY_IDENTIFIER

Bluesky のハンドル（ユーザー名）です。次のどちらの形式でも指定できます。

• username.bsky.social（例：alice.bsky.social）
• @username.bsky.social（例：@alice.bsky.social）

BLUESKY_APP_KEY

通常の Bluesky パスワードとは異なる、アプリパスワードです。作成する手順は次のとおりです。

1. Bluesky Settings に移動します
2. 「Privacy and Security」→「App Passwords」を開きます
3. 「Add App Password」をクリックします
4. 名前を付けます（例：「MCP Server」）
5. 生成されたパスワードをコピーします（xxxx-xxxx-xxxx-xxxx のような形式です）

⚠️ 重要：通常のアカウントパスワードではなく、アプリパスワードを使用してください。

2. インストール

オプション A：Smithery 経由でインストールする（推奨）

Smithery を使って、Claude Desktop 用の Bluesky Context Server を自動的にインストールするには：

npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude

次に、生成された設定に認証情報を追加します。

オプション B：手動インストール

1. このリポジトリをクローンまたはダウンロードします
2. MCP サーバーを使用するように Claude Desktop アプリを設定します。

Bun を使用する場合：

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "/Users/your-username/.bun/bin/bun",
			"args": [
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}

Node.js を使用する場合：

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "node",
			"args": [
				"--experimental-strip-types",
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}

3. Claude Desktop を再起動します

3. 接続をテストする

セットアップが完了したら、次のような内容を Claude に尋ねて、接続をテストできます。

• 「Bluesky のプロフィールを取得できますか？」
• 「Bluesky の最近の投稿を見せてください」
• 「Bluesky で AI に関する投稿を検索してください」

利用可能な MCP ツール

このサーバーは、Claude が使用できる次のツールを提供します。

プロフィールとアカウントのツール

bluesky_get_profile

表示名、自己紹介、フォロワー数など、Bluesky のプロフィール情報を取得します。

• パラメーター：なし
• 戻り値：プロフィールデータ一式

bluesky_get_follows

フォローしているアカウントの一覧を取得します。

• パラメーター：
  • limit（任意）：返す項目の最大数（デフォルト 50、最大 100）
  • cursor（任意）：次のページを取得するためのページネーションカーソル
• 戻り値：プロフィール情報を含む、フォロー中のアカウント一覧

bluesky_get_followers

自分をフォローしているアカウントの一覧を取得します。

• パラメーター：
  • limit（任意）：返す項目の最大数（デフォルト 50、最大 100）
  • cursor（任意）：次のページを取得するためのページネーションカーソル
• 戻り値：プロフィール情報を含む、フォロワーの一覧

投稿とフィードのツール

bluesky_get_posts

自分の最近の投稿を取得します。

• パラメーター：
  • limit（任意）：返す項目の最大数（デフォルト 50、最大 100）
  • cursor（任意）：次のページを取得するためのページネーションカーソル
• 戻り値：エンゲージメントデータを含む、自分の最近の投稿

bluesky_get_personal_feed

パーソナライズされた Bluesky のタイムライン／フィードを取得します。

• パラメーター：
  • limit（任意）：返す項目の最大数（デフォルト 50、最大 100）
  • cursor（任意）：次のページを取得するためのページネーションカーソル
• 戻り値：パーソナライズされたフィードの投稿

bluesky_get_liked_posts

「いいね」した投稿を取得します。

• パラメーター：
  • limit（任意）：返す項目の最大数（デフォルト 50、最大 100）
  • cursor（任意）：次のページを取得するためのページネーションカーソル
• 戻り値：「いいね」した投稿

検索ツール

bluesky_search_posts

Bluesky 全体から投稿を検索します。

• パラメーター：
  • query（必須）：検索クエリ文字列
  • limit（任意）：返す項目の最大数（デフォルト 50、最大 100）
  • cursor（任意）：次のページを取得するためのページネーションカーソル
• 戻り値：検索クエリに一致する投稿

bluesky_search_profiles

Bluesky のユーザープロフィールを検索します。

• パラメーター：
  • query（必須）：検索クエリ文字列
  • limit（任意）：返す最大件数（デフォルトは 50、最大 100）
  • cursor（任意）：次のページを取得するためのページネーションカーソル
• 戻り値：検索クエリに一致するユーザープロフィール

使用例

設定が完了したら、Claude に次のような質問ができます。

• 「今日の Bluesky フィードには何がある？」
• 「Bluesky で TypeScript に関する投稿を検索して」
• 「最近のフォロワーを教えて」
• 「最近「いいね」した投稿を表示して」
• 「AI に関心のある Bluesky ユーザーを見つけて」

トラブルシューティング

よくある問題

1. 「Authentication failed」：BLUESKY_APP_KEY と BLUESKY_IDENTIFIER をもう一度確認してください
2. 「Server not responding」：Bun がインストールされていることと、サーバーへのパスが正しいことを確認してください
3. 「Permission denied」：サーバーファイルに実行権限があることを確認してください

ヘルプ

問題が発生した場合：

1. Bluesky の認証情報が正しいことを確認してください
2. Bun がインストールされていることを確認してください：bun --version
3. サーバーを手動でテストしてください：cd packages/server && bun start
4. Claude Desktop のログでエラーメッセージを確認してください