Skip to content
MCP server

Oxynote

Self-hosted team docs with live Prometheus and Loki charts, reviewed like pull requests

Pricing
Open source
Platforms
self-hosted, Web, API
Runs
Remotely
Version
0.9.0
Listing updated
1 day ago

About Oxynote

Oxynote is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

Oxynote starts from a complaint the authors describe at length: the wiki says how a service works, Grafana or Datadog shows its metrics, and the fix commands sit in a terminal history. Their answer is a self-hosted workspace where a page holds the explanation, live metric charts and logs together, and any change goes through a draft, a diff and an approval, much like a pull request. The authors previously wrote the ttlcache library.

A Live Metrics block draws a time series, bar chart or gauge from PromQL or SQL queries, and Grafana macros such as $__rate_interval work. A Live Logs block queries a log source such as Loki and colours each level. Pages can query Prometheus, Loki, PostgreSQL, Supabase, MySQL or MariaDB, and SQL sources need a read-only database user so a page cannot alter data. Uptime monitors, AI evals, a database viewer and admin actions are described as in development.

The MCP endpoint is served from your own instance at /core/api/mcp, letting an agent read, write and query the docs. It runs as one Docker container; the README notes a default admin login that you must change before others can reach it.

What it does

Live metric charts
Draws charts from PromQL or SQL queries inside a page.
Live logs
Shows the newest logs with level colours and a volume strip.
Draft and review flow
Changes to text and charts go through a diff and approval.
Multiple data sources
Queries Prometheus, Loki, PostgreSQL, Supabase, MySQL and MariaDB.
Read-only SQL
Requires read-only database users so pages cannot change data.
Single container
Starts with one docker run command and a data volume.

Good for

  • Keep on-call runbooks next to the charts they explain
  • Review a change to a dashboard and its description together
  • Let an agent query team docs and live metrics over MCP
  • Migrate Grafana queries into documentation pages

Pricing

Open source

Self-hosted; open source on GitHub

Oxynote FAQ

How do I run it?

With one Docker container: docker run -p 8080:8080 with a data volume and the ghcr.io/oxynote/oxynote image.

Which data sources can pages query?

Prometheus, Loki, PostgreSQL, Supabase, MySQL and MariaDB.

Can a page change my database?

No. SQL sources need a read-only database user.

What should I do after first start?

Change the default admin password, which the login page displays until you do.

Is Oxynote free?

Yes. Oxynote is open source, so you can use and self-host it for free.

What are the best alternatives to Oxynote?

The closest alternatives to Oxynote are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Oxynote

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools