bluesky-daily-mcp logo

bluesky-daily-mcp

by briangershon

An MCP Server to help you surface the most interesting topics from your Bluesky follows daily. It retrieves and analyzes posts from your Bluesky feed, providing a summary of the day's most relevant content.

View on GitHub

Last updated: N/A

What is bluesky-daily-mcp?

bluesky-daily-mcp is an MCP (Model Context Protocol) server designed to retrieve, process, and summarize posts from your Bluesky social media follows for a given day. It leverages the bsky-tldr npm package to normalize posts and prepares them for analysis by Large Language Models (LLMs).

How to use bluesky-daily-mcp?

  1. Install the MCP Server with your MCP Client (e.g., Claude Desktop). 2. Configure the server by adding it to your client's configuration file, providing your Bluesky handle, app password, timezone offset, and request timeout. 3. Restart your MCP Client. 4. Initiate a conversation and request posts from a specific date (e.g., 'Retrieve Bluesky posts from yesterday').

Key features of bluesky-daily-mcp

  • Retrieves all posts from your Bluesky follows for a given day.

  • Provides sample prompts for analyzing posts with LLMs.

  • Caches retrieved posts for efficient access.

  • Normalizes posts into a consistent JSON format using bsky-tldr for easy consumption by LLMs.

Use cases of bluesky-daily-mcp

  • Daily summary of trending topics among your Bluesky follows.

  • Identifying key themes and discussions within your network.

  • Generating insights and reports based on social media activity.

  • Feeding social media data into LLMs for further analysis and content creation.

FAQ from bluesky-daily-mcp

What is an MCP Server?

An MCP (Model Context Protocol) server provides context to a Large Language Model (LLM) client, allowing it to access external data and perform more complex tasks.

What is the purpose of the TIMEZONE_OFFSET?

The TIMEZONE_OFFSET variable defines what a 'day' means for you, ensuring that posts are retrieved according to your local time rather than UTC.

Where do I get my BLUESKY_APP_PASSWORD?

You can generate a Bluesky app password from the Bluesky App Passwords Settings page on the Bluesky website.

Why is the PATH environment variable needed?

The PATH environment variable is needed if you use NVM to manage your Node.js versions. It ensures that the correct version of npx or node is used.

What happens if I don't set REQUEST_TIMEOUT_MS?

Without setting REQUEST_TIMEOUT_MS, the request to retrieve posts will have a default timeout of approximately 60 seconds. Setting it to a higher value (e.g., 120000 ms) is recommended to avoid timeouts when retrieving a large number of posts.