BlueskyとAT ProtocolのためのMCPサーバー
アカウントのパスワードを渡さずに、MCPクライアントからBlueskyとAT Protocolの公開ツールを利用できます。
著者:Bluesky.botチーム
- 公開日:
- 更新日:
- 確認日:
クライアントでできること
公開ツールはハンドルやDIDの解決、公開データの確認、計算を行います。このMCPエンドポイントはBlueskyのアプリパスワードを受け取りません。作成者トークンやMCP OAuth接続で公開ツールの利用枠を増やせます。掲載情報のツールには専用権限が必要で、ハンドルの取得や解放はできません。
| ツール | MCP名 | HTTPキャッシュ | 利用枠のコスト |
|---|---|---|---|
| 自動化の公開宣言チェッカー アカウントが公開する自動化の印を確認します。 | bot_signals | 60秒 | 3単位 |
| DID 検索 Bluesky のハンドルの裏にある DID を調べる。 | find_did | 60秒 | 1単位 |
| ハンドル検索(DID からハンドル) DID の裏にあるハンドルを調べる。 | find_handle | 60秒 | 1単位 |
| Bluesky whois ハンドルや DID について公開されているすべて。 | whois_lookup | 60秒 | 3単位 |
| アカウント年齢チェッカー アカウントがいつ Bluesky に参加したかを調べる。 | check_account_age | 60秒 | 1単位 |
| AT URI コンバーター bsky.app のリンクと at:// の URI を相互に変換。 | convert_at_uri | 60秒 | 1単位 |
| TID デコーダー レコードキーに隠れた日付を読む。 | decode_tid | 1年 | 1単位 |
| 投稿の文字数カウンター Bluesky と同じ方法で投稿の文字数を数えます。 | count_post_characters | 1年 | 1単位 |
| リッチテキストのファセットビルダー メンション、リンク、ハッシュタグをバイト位置つきで。 | build_post_facets | キャッシュなし | リクエストによる |
| 独自ドメインのハンドルチェッカー ハンドルが無効になる理由と、その直し方がわかります。 | check_custom_handle | キャッシュなし | 2単位 |
| ハンドルの空き状況チェッカー その名前は Bluesky で空いていますか? | check_handle_availability | キャッシュなし | 1単位 |
| PLC 履歴ビューア アカウントのハンドル変更、サーバー移行、鍵の変更をすべて。 | plc_history | 5分 | 2単位 |
| スターターパック分析 スターターパックのメンバーを、数字やボットと一緒に。 | analyse_starter_pack | 5分 | リクエストによる |
| 投稿とスレッドのビューア 公開されている Bluesky の投稿やスレッドを、アカウントなしで読めます。 | view_bluesky_post | 60秒 | 3単位 |
| フィードインスペクター カスタムフィードをプレビューし、何も表示されない理由を調べます。 | inspect_bluesky_feed | キャッシュなし | 3単位 |
| ラベルインスペクター 誰がラベルを付けたか、その意味を確認できます。 | inspect_bluesky_labels | 5分 | リクエストによる |
| フォロワー一覧のエクスポート 公開フォロワー・フォロー一覧をCSVでバックアップ。 | preview_bluesky_follows | 5分 | 2単位 |
| リポジトリエクスプローラー アカウント自身のサーバーにある公開データを閲覧します。 | explore_atproto_repo | 5分 | 2単位 |
| MCP名 | ツール | 認証 | 機能 |
|---|---|---|---|
| check_handle | Bluesky.botハンドルの空きを確認 | 公開 | 読み取り専用 |
| resolve_handle | 取得済みBluesky.botハンドルを解決 | 公開 | 読み取り専用 |
| search_bots | 公開ボットディレクトリを検索 | 公開 | 読み取り専用 |
| get_bot | 公開ボットの詳細を取得 | 公開 | 読み取り専用 |
| search_docs | 開発者ドキュメントを検索 | 公開 | 読み取り専用 |
| read_doc | ドキュメントをMarkdownで取得 | 公開 | 読み取り専用 |
| list_my_bots | トークン所有者のボットを一覧(handles権限) | 必要な権限を持つ作成者トークン | 読み取り専用 |
| get_listing | 自分のボットの掲載情報を取得(listing権限) | 必要な権限を持つ作成者トークン | 読み取り専用 |
| update_listing | 自分のボットの掲載情報のみ更新(listing権限) | 必要な権限を持つ作成者トークン | 自分の掲載情報のみ更新 |
接続の設定
Streamable HTTP対応クライアントを、このサイトの /api/mcp に接続します。設定例は、あらゆるデスクトップクライアントのバージョンを試したという意味ではありません。公開ツールに認証情報は不要です。連携リファレンスでプロトコルと認証を確認できます。
claude mcp add --transport http bluesky-bot https://bluesky.bot/api/mcp{
"servers": {
"bluesky-bot": {
"type": "http",
"url": "https://bluesky.bot/api/mcp"
}
}
}{
"mcpServers": {
"bluesky-bot": {
"url": "https://bluesky.bot/api/mcp"
}
}
}Streamable HTTP対応のClaude Desktopでは、このサイトの/api/mcpのURLをリモートコネクターとして追加します。必要な場合はOAuth接続を使います。
設定形式はクライアントのバージョンにより異なります。この例にBlueskyのアプリパスワードを入れないでください。任意のBluesky.botトークンやOAuth接続にはそれぞれの権限があります。
記録した3つのプロトコルセッション
MCP JavaScript SDKクライアントのバージョン1.32.2で、実際に当サービスへ接続した記録です。各セッションは初期化、ツール一覧の取得、公開ツール1件の呼び出し、接続終了を行いました。質問は目的を示し、結果はツールの回答そのものです。これはプロトコルのテストで、AIモデルとの架空の会話ではありません。
入力
{
"question": "Which DID does the official bluesky.bot handle resolve to?",
"method": "tools/call",
"params": {
"name": "find_did",
"arguments": {
"handle": "bluesky.bot"
}
}
}取得した出力
{
"client": "MCP JavaScript SDK",
"clientVersion": "1.32.2",
"transport": "Streamable HTTP",
"server": {
"name": "bluesky-bot",
"title": "Bluesky.bot",
"version": "1.1.0"
},
"result": {
"content": [
{
"type": "text",
"text": "{\"status\":\"found\",\"handle\":\"bluesky.bot\",\"unicodeHandle\":null,\"dns\":{\"status\":\"found\",\"did\":\"did:plc:ulmk4vmvoobkemd3w2tkwhu5\"},\"https\":{\"status\":\"none\"},\"appview\":{\"status\":\"found\",\"did\":\"did:plc:ulmk4vmvoobkemd3w2tkwhu5\"},\"did\":\"did:plc:ulmk4vmvoobkemd3w2tkwhu5\",\"method\":\"dns\",\"verified\":true,\"claimedHandle\":null,\"warnings\":[]}\n\nTool page: https://bluesky.bot/tools/did-finder"
}
],
"structuredContent": {
"tool": "did-finder",
"url": "https://bluesky.bot/tools/did-finder",
"result": {
"status": "found",
"handle": "bluesky.bot",
"unicodeHandle": null,
"dns": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"https": {
"status": "none"
},
"appview": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5",
"method": "dns",
"verified": true,
"claimedHandle": null,
"warnings": []
}
}
}
}入力
{
"question": "Does this short sample fit a Bluesky post?",
"method": "tools/call",
"params": {
"name": "count_post_characters",
"arguments": {
"text": "Hello Bluesky! 👋"
}
}
}取得した出力
{
"client": "MCP JavaScript SDK",
"clientVersion": "1.32.2",
"transport": "Streamable HTTP",
"server": {
"name": "bluesky-bot",
"title": "Bluesky.bot",
"version": "1.1.0"
},
"result": {
"content": [
{
"type": "text",
"text": "{\"graphemes\":16,\"bytes\":19,\"graphemesLeft\":284,\"bytesLeft\":2981,\"over\":false,\"limits\":{\"graphemes\":300,\"bytes\":3000},\"parts\":[]}\n\nTool page: https://bluesky.bot/tools/character-counter"
}
],
"structuredContent": {
"tool": "character-counter",
"url": "https://bluesky.bot/tools/character-counter",
"result": {
"graphemes": 16,
"bytes": 19,
"graphemesLeft": 284,
"bytesLeft": 2981,
"over": false,
"limits": {
"graphemes": 300,
"bytes": 3000
},
"parts": []
}
}
}
}入力
{
"question": "What timestamp does this example record key encode?",
"method": "tools/call",
"params": {
"name": "decode_tid",
"arguments": {
"tid": "3l6oveex3ii2l"
}
}
}取得した出力
{
"client": "MCP JavaScript SDK",
"clientVersion": "1.32.2",
"transport": "Streamable HTTP",
"server": {
"name": "bluesky-bot",
"title": "Bluesky.bot",
"version": "1.1.0"
},
"result": {
"content": [
{
"type": "text",
"text": "{\"tid\":\"3l6oveex3ii2l\",\"timestamp\":\"2024-10-17T07:06:51.642Z\",\"microseconds\":\"1729148811642318\",\"clockId\":17,\"topBitSet\":false}\n\nTool page: https://bluesky.bot/tools/tid-decoder"
}
],
"structuredContent": {
"tool": "tid-decoder",
"url": "https://bluesky.bot/tools/tid-decoder",
"result": {
"tid": "3l6oveex3ii2l",
"timestamp": "2024-10-17T07:06:51.642Z",
"microseconds": "1729148811642318",
"clockId": 17,
"topBitSet": false
}
}
}
}用途に合うサーバーを選ぶ
当サイトの公開ツールは、アカウントの認証情報なしで識別情報やプロトコルを確認する用途に向いています。エージェントから投稿するなら、明示的な書き込み権限を持つサーバーが適している場合があります。アプリパスワードを秘密に保ち、許可するツールを確認し、重要な変更は人が確認してください。読み取り専用の注釈があっても、外部テキストの指示が信頼できるとは限りません。
以下は2026年11月15日に各リンク先READMEで確認した内容です。他のサーバーを実行したり、安全性を監査したりはしていません。機能と要件は変わることがあります。
| サーバー | 通信方式 | 認証 | 機能 | ライセンス | 最新コミット | 向いている用途 | README確認日 |
|---|---|---|---|---|---|---|---|
| brianellin/bsky-mcp-server | ローカルstdio | Blueskyアプリパスワード | 読み取り・書き込み | MIT | アカウントのタイムラインと投稿 | ||
| Ravishka17/Bluesky-MCP | Streamable HTTP | 公開読み取り・書き込みはヘッダーでアプリパスワード | 読み取り・書き込み | Unlicense | 書き込み対応の自前HTTPクライアント | ||
| cameronrye/atproto-mcp | stdio・任意のHTTP | 公開読み取り・非公開データと書き込みは認証が必要 | 読み取り・書き込み | MIT | 幅広いAT Protocolアカウント操作 |
制限と適切な利用
匿名利用:60秒あたり60単位、24時間あたり2000単位。有効な作成者トークンの所有者に稼働中のボットが1つ以上ある場合、両方の上限が10倍になります。
各呼び出しは両方の利用枠からツールの重みを消費します。サーバー検索には共通の外部アクセス枠もあるため、個別の枠が残っていても複雑な確認が拒否される場合があります。
MCPには別途、匿名クライアントの60秒あたり120リクエストという上限があります。条件を満たす作成者トークンではこの上限も増えます。ツールを呼ばない検出やツール一覧の取得も数えます。
MCPツールの失敗は結果内のisError: trueで返します。トランスポートの検査はHTTPエラーを返す場合があり、利用枠超過の拒否にはRetry-Afterが含まれます。JSON-RPCエラーの詳細はプロトコルのリファレンスをご覧ください。
ツール名と経路を集計し、入力値は集計しません。ツールの入力を含むクエリはアクセスログから除外します。秘密、非公開投稿、他人の認証情報は送らないでください。
無料のベストエフォートサービスで、稼働率のSLAはありません。キャッシュ可能な結果を再利用し、再試行の待ち時間を守ってください。別の用途はお問い合わせください。
HTTPという選択肢
MCPが不要なら無料ツールAPIを利用できます。同じツール定義からスキーマと回答を提供します。このページは、MCPディレクトリへの登録、稼働保証、独立したセキュリティ監査、他社サービスの実地テストを意味しません。
ターミナルを使う場合は、Blueskyのコマンドラインクライアント比較をご覧ください。公開済みのbsbotのバージョンと現在の制限も説明しています。
よくある質問
Blueskyのパスワードは必要ですか
不要です。公開ツールにパスワードやトークンは必要ありません。任意のBluesky.botトークンやOAuth接続にはそれぞれ権限があります。
投稿、フォロー、投稿削除はできますか
公開ツールではできません。掲載情報のツールは明示的な許可の下で作成者自身のディレクトリ情報のみ変更でき、Blueskyのハンドルは管理できません。
通信方式は何ですか
/api/mcpでStreamable HTTPを使います。対応クライアントが必要で、設定形式はバージョンによります。
代わりにHTTP APIを使えますか
はい。/api/v1/toolsのAPIは同じ公開ツール定義を提供します。