Files
StarPunk/docs/architecture/INDEX.md
T
PhilandClaude Opus 5.5 84411a16d9 feat: MCP server for AI clients (v2.15.0, ADR-075)
Add an MCP server at SITE_URL/mcp so AI assistants (claude.ai connectors,
Claude Code) can search, read and write notes.

- starpunk/mcp_server: official MCP SDK 2.3, stateless Streamable HTTP with
  JSON responses, served by uvicorn as a sidecar from the same image.
  Ten tools; writes go through the Micropub handlers.
- IndieAuth: RFC 8707 resource indicators bound to codes and tokens
  (migration 022), client ID metadata document + public client metadata,
  draft in scopes_supported, default MCP scopes, consent screen note.
- BACKGROUND_WORKERS_ENABLED flag so the sidecar runs no workers.
- Docs: ADR-075, architecture/mcp.md and updates; CHANGELOG.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 16:36:58 -07:00

2.5 KiB
Raw Blame History

Architecture Documentation Index

This directory describes the current design of StarPunk (v2.14.0). Per ../DOCUMENTATION.md it is updated at the end of each release. Decisions and their history are in ../decisions/; per-release designs and reports are in ../design/. The original v0.x technology choices are kept in ../design/v0.x/technology-stack-legacy.md.

Documents

Document Description
overview.md System overview: purpose, request flow, modules and routes, background workers, storage, auth model, URL surface, caching, security posture
technology-stack.md Current runtime, Python dependencies, standards implemented, testing and CI
database.md SQLite schema after migrations 001–022, migration runner and its lock, connection pool
deployment.md Container image stages, CI workflow, release process, /data layout, reverse proxy, all environment variables
simplified-auth-architecture.md Admin login via OpenID Connect and the built-in IndieAuth server that issues Micropub tokens (ADR-064)
indieweb-protocols.md How Micropub, IndieAuth, Webmention, microformats2, WebSub and the feeds are implemented (including backfeed responses, web actions and notifications), with compliance status and known gaps
mcp.md The MCP server for AI clients: sidecar, authorization flow, tools (ADR-075)
syndication-architecture.md Crossposting (POSSE) to GoToSocial, Bluesky and Threads: syndications table, worker, reconcile rules, backfeed of responses (ADR-073)

Where to start

  • New to the code: overview.md, then technology-stack.md.
  • Changing the schema: database.md (migrations must be safe inside one transaction).
  • Releasing or operating the site: deployment.md.
  • Working on auth, Micropub, Webmention or WebSub: simplified-auth-architecture.md and indieweb-protocols.md, plus the ADRs they link to.

Last Updated: 2026-11-10 (v2.14.0)