MCP Bluesky Stock Sentiment

MCP Bluesky Stock Sentiment

Analyze recent Bluesky posts about stocks and return a concise sentiment summary using Cloudflare Workers AI — exposed as an MCP server you can connect to from any MCP‑compatible client.

What you get

• Cloudflare Worker with Hono, serving an MCP endpoint at /mcp.
• Tool: analyze_stock_posts — searches recent Bluesky posts, filters for stock‑related content, and runs sentiment via @cf/huggingface/distilbert-sst-2-int8.
• Simple JSON metadata on / for quick health checks.

Quickstart

• Prereqs: Node 18+, Cloudflare account, Wrangler auth (npx wrangler login).
• Install: npm install
• Dev: npm run dev (serves on http://localhost:8787)
• Deploy: npm run deploy
• Typegen: npm run cf-typegen (optional; syncs Worker bindings types)

MCP Endpoint

• Local: http://localhost:8787/mcp
• Prod: <your-workers-subdomain>.workers.dev/mcp
• Server name: bluesky-stock-sentiment (see src/index.ts).

Available Tool

• analyze_stock_posts
  • Input: { count?: number } — number of posts to analyze (1–10, default 2)
  • Behavior: Fetches recent posts from Bluesky’s public search API, filters to stock‑related text, analyzes each with Workers AI, and returns a textual summary (totals, percentages, average confidence, and per‑post details with author, likes, reposts, timestamp, and URI).

Config and Extensibility

• Sentiment model: src/lib/sentiment.ts
  • Default: @cf/huggingface/distilbert-sst-2-int8
  • Swap to any Workers AI text‑classification model if you prefer.
• Stock filtering: src/lib/stock-filter.ts
  • Update the keyword list to fine‑tune what counts as a “stock post”.
• Bluesky search: src/lib/bluesky-api.ts
  • Uses the public unauthenticated search API and basic heuristics to avoid duplicates.
• Firehose (optional): src/lib/firehose.ts
  • Example collector that connects to Bluesky’s firehose via WebSocket and filters in real time. This is not wired into the Worker route; use it as a reference for server/runtime environments that support outbound WebSocket connections.

Endpoints

• GET / — returns service metadata (name, version, description, available tools).
• ALL /mcp — MCP over HTTP transport (via mcp-lite). Point your MCP client here.

Notes

• You must bind Workers AI in Wrangler (already configured in wrangler.jsonc under ai.binding = "AI").
• Bluesky’s public search API may rate‑limit or change behavior; the tool is resilient but results vary over time.

Project Layout

• src/index.ts — Hono app, MCP server wiring, routes.
• src/mcp/tools.ts — analyze_stock_posts tool registration and handler.
• src/lib/* — sentiment analysis, filtering, Bluesky integrations.

License

• Provided as‑is; add a license if you plan to distribute.