Bluesky Daily MCP

🚀 bluesky-daily-mcp

このMCPサーバーは、Blueskyでフォローしているユーザーから毎日最も面白いトピックを抽出するのに役立ちます。

使用方法の例については、"Bluesky Feedを探索するMCPサーバーの構築" を参照してください。

🚀 クイックスタート

このMCPサーバーを使用することで、Blueskyでフォローしているユーザーの投稿から毎日面白いトピックを見つけることができます。

✨ 主な機能

• 特定の日にフォローしているユーザーのすべての投稿を取得するツール
• 投稿を分析するためのサンプルプロンプト
• 特定の日の投稿をキャッシュする機能

bsky-tldr npmパッケージを通じて、(a) 必要なフィールドの情報のみを取得し、(b) 要求された日付に効率的に投稿を取得します。

このMCPサーバーでは、より説明的なフィールド名を追加し、作者と投稿情報をまとめてLLMが利用しやすいようにしています。

type StandalonePost = {
  urlToOriginalPost: string;
  authorIdentifier: string;
  authorNameOrHandle: string;
  content: string;
  links: string[];
  isRepost: boolean;
};

📦 インストール

1. .envファイルの設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

BLUESKY_HANDLE=あなたのBlueskyハンドル
BLUESKY_APP_PASSWORD=あなたのBlueskyアプリパスワード
TIMEZONE_OFFSET=タイムゾーンオフセット（例：Asia/Shanghai または UTC+8）

2. 依存関係のインストールとビルド

以下のコマンドを実行して、プロジェクトの依存関係をインストールします。

npm install

次に、プロジェクトをビルドします。

npm run build

💻 使用例

基本的な使用法

• Claude Desktopを起動し、新しい会話を開始します。
• 「昨日のBlueskyの投稿を取得」または「4月2日のBlueskyの投稿を取得」（または他の任意の日付）と入力します。

🔧 技術詳細

制限事項

• このツールは特定の日にフォローしているユーザーのすべての投稿を取得します。投稿数が多くなると、MCPクライアントまたはLLMによって破棄される投稿がある可能性があります。
• 必要な内容のみを毎日取得することをおすすめします。

開発者向け情報

ローカル開発の実行

開発用にローカルの .env ファイルを設定します。

BLUESKY_HANDLE=あなたのBlueskyハンドル
BLUESKY_APP_PASSWORD=あなたのBlueskyアプリパスワード
TIMEZONE_OFFSET=タイムゾーンオフセット（例：Asia/Shanghai または UTC+8）

MCPインスペクターを使用してデバッグします。

npm install
npm run build && npx @modelcontextprotocol/inspector -e BLUESKY_HANDLE=XXX -e BLUESKY_APP_PASSWORD=XXX -e TIMEZONE_OFFSET=XXX node dist/index.js

ログを確認してデバッグします。

tail -n 20 -F ~/Library/Logs/Claude/mcp-server-bluesky-daily-mcp.log

テストの実行またはカバレッジレポートの生成

npm test
npm run coverage

投稿の手動取得

.post.retrieve コードが正常に動作することを確認したい場合は、以下のコマンドを実行します。

npm run retrieve-posts

NPMへの公開手順

最新のコードをメインブランチにマージした後、以下の手順を実行します。

1. ローカルで：git checkout main && git pull
2. npm version patch # または minor、major
3. git push --follow-tags
4. GitHubが自動的にバージョンを公開します。