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.
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?
- 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?
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?
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?
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?
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?
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.