Skip to main content
AllMCPs
BrowseBestCategoriesStackCompareToolsGuidesBlog
Log in Submit MCP

Stay in the loop

Get new MCP servers and top picks in your inbox.

AllMCPs

The open directory for discovering and installing Model Context Protocol servers.

AllMCPs on GitHub (opens in a new tab)
Launched onTiny Startupstinystartups.com
Explore
  • Browse servers
  • Best MCP servers
  • Categories
  • MCP clients
  • Agent prompts
  • Stack Builder
  • Compare servers
  • Random discovery New
  • Submit a server
  • Pricing & Boost Boost
Learn
  • Guides hub
  • What is MCP?
  • Install guide
  • Build an MCP server
  • Deploy an MCP server
  • Security guide
  • Troubleshooting
  • MCP for SEO & AEO
  • Protocol versioning
  • Blog & updates
Tools
  • All developer tools
  • Config generator
  • Config validator
  • Config auditor
  • MCP playground
  • Token calculator
  • OpenAPI β†’ MCP
  • Badge generator
For agents
  • REST API docs
  • Trust & traffic Live
  • Remote MCP server SSE β†— (opens in a new tab)
  • llms.txt β†— (opens in a new tab)
  • Catalog JSON β†— (opens in a new tab)
Company
  • About
  • Advertise Sponsor
  • Contact
  • GitHub β†— (opens in a new tab)
  • Terms
  • Privacy
AllMCPs VerifiedAllMCPs VerifiedFeatured on Nick LaunchesFeatured on Nick LaunchesLaunch Llama NewsletterLaunch Llama NewsletterVerified DR - allmcps.comVerified DR - allmcps.comFeatured on SaaSGrowFeatured on SaaSGrowFeatured on Twelve ToolsFeatured on Twelve ToolsFeatured on Saaspa.geFeatured on Saaspa.geFeatured on Findly.toolsFeatured on Findly.toolsFeatured on Startup FameFeatured on Startup FameFeatured on LaunchKiwiFeatured on LaunchKiwiFeatured on ScrollLaunchFeatured on ScrollLaunchFeatured on DailyPingsFeatured on DailyPingsFazier badgeFazier badgeFeatured on NewTool.siteFeatured on NewTool.siteFeatured on saasfame.comFeatured on saasfame.comDR Checker - Domain RatingDR Checker - Domain RatingListed on Turbo0Listed on Turbo0Launched on LaunchBoard - Product Launch PlatformLaunched on LaunchBoard - Product Launch PlatformList on SimilarlabsList on Similarlabshttps://codetrendy.comhttps://codetrendy.comListed on DevTool.ioFeatured on BuildlistFeatured on BuildlistLaunched on Tiny StartupsFeatured on ShowMeBestAIFeatured on ShowMeBestAIFind us on LaunchZoneFind us on LaunchZoneAllMCPs VerifiedAllMCPs VerifiedFeatured on Nick LaunchesFeatured on Nick LaunchesLaunch Llama NewsletterLaunch Llama NewsletterVerified DR - allmcps.comVerified DR - allmcps.comFeatured on SaaSGrowFeatured on SaaSGrowFeatured on Twelve ToolsFeatured on Twelve ToolsFeatured on Saaspa.geFeatured on Saaspa.geFeatured on Findly.toolsFeatured on Findly.toolsFeatured on Startup FameFeatured on Startup FameFeatured on LaunchKiwiFeatured on LaunchKiwiFeatured on ScrollLaunchFeatured on ScrollLaunchFeatured on DailyPingsFeatured on DailyPingsFazier badgeFazier badgeFeatured on NewTool.siteFeatured on NewTool.siteFeatured on saasfame.comFeatured on saasfame.comDR Checker - Domain RatingDR Checker - Domain RatingListed on Turbo0Listed on Turbo0Launched on LaunchBoard - Product Launch PlatformLaunched on LaunchBoard - Product Launch PlatformList on SimilarlabsList on Similarlabshttps://codetrendy.comhttps://codetrendy.comListed on DevTool.ioFeatured on BuildlistFeatured on BuildlistLaunched on Tiny StartupsFeatured on ShowMeBestAIFeatured on ShowMeBestAIFind us on LaunchZoneFind us on LaunchZone
Β© 2026 Jackalope Digital LLC. All rights reserved.
  1. Home
  2. 🧠 Knowledge & Memory
  3. Flaiwheel
Flaiwheel logo
Health: ActiveRecent health check succeeded.Last checked 9/9/2026, 11:17:22 AM

Flaiwheel

User RatingsBe the first to rate and review this MCP server!
View Repository6 GitHub StarsTotal stargazers on GitHub for the source repository (6 stars).Visit Website

Self-hosted MCP server providing persistent memory, governance, and hybrid search for AI coding agents with git-native knowledge capture.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β€” or use 1-click editor setup below.

Add to CursorAdd to VS Code
Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag β€” we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON β–Ύ

Client Config & Setup

Choose your client or environment
Target File:~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "dl4rce-flaiwheel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8081/sse"
      ]
    }
  }
}

πŸ’‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Install Directory Badge Claim listing Alternatives🧠 More in Knowledge & Memory

Overview

This server offers a self-hosted memory and governance layer for AI coding agents, enabling persistent knowledge retention across sessions to reduce repeated bugs and knowledge loss. It integrates tightly with git repositories to automatically capture structured knowledge from commits and enforces documentation and quality gates. Hybrid semantic and keyword search with cross-encoder reranking provides precise context retrieval for real codebases. Use it when you need to manage AI agent knowledge reliably within your own infrastructure and want to compound engineering knowledge over time.

Use cases

β€’Enable AI coding agents to search project knowledge before generating code
β€’Automatically document bug fixes and architectural decisions after coding tasks
β€’Capture and structure knowledge from git commits without manual intervention
β€’Analyze legacy codebases to identify documentation priorities and duplicates
β€’Maintain up-to-date architecture diagrams and executable test flows

Key features

β€’Hybrid search combining semantic vectors, BM25 keyword search, and cross-encoder reranking
β€’Git-native automation capturing commit messages as structured knowledge documents
β€’Behavioral directives enforcing agent search-before-code and document-after-fix workflows
β€’Cold-start codebase analyzer producing reports on language distribution and documentation gaps
β€’Structured write tools for bugfixes, architecture, APIs, best practices, and tests
β€’Multi-project support within a single Docker container with zero cloud dependencies

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Flaiwheel.

Extracted Tool Capabilities
Hybrid search combining semantic vectors, BM25 keyword search, and cross-encoder reranking
Git-native automation capturing commit messages as structured knowledge documents
Behavioral directives enforcing agent search-before-code and document-after-fix workflows
Cold-start codebase analyzer producing reports on language distribution and documentation gaps
Structured write tools for bugfixes, architecture, APIs, best practices, and tests
Multi-project support within a single Docker container with zero cloud dependencies

Documentation Overview

Flaiwheel

flaiwheel MCP server Available on Glama

Self-hosted memory & governance layer for AI coding agents. Turn every bug fix into permanent knowledge. Zero cloud. Zero lock-in.

πŸš€ Why Flaiwheel Exists

AI coding agents forget everything between sessions. That leads to repeated bugs, lost architectural decisions, and knowledge decay.

Flaiwheel ensures:

  • Agents search before coding
  • Agents document after fixing
  • Commits automatically capture knowledge
  • Memory compounds over time

Every bug fixed makes the next bug cheaper.

🧠 How Flaiwheel Is Different

  • Persistent AI Memory That Compounds β€” knowledge doesn't reset between sessions.
  • Git-Native Automation β€” commits automatically become structured knowledge.
  • Governance, Not Just Storage β€” quality gates + enforced documentation.
  • Hybrid Search + Reranking β€” high-precision context for real codebases.
  • Fully Self-Hosted β€” single Docker container, no external infrastructure.
  • Zero Lock-In β€” all knowledge stored as structured flat files in Git.

βœ… Who Flaiwheel Is For

  • Engineering teams using AI coding assistants in real projects
  • Codebases where repeated bugs are expensive
  • Teams requiring full data control
  • AI-native development environments

❌ Not For

  • Small hobby projects under a few thousand lines
  • Developers who just want better autocomplete
  • Pure SaaS workflows with no interest in self-hosting

πŸ†š Where Flaiwheel Fits

  • AI coding tools generate code.
  • RAG tools retrieve documents.
  • Flaiwheel governs and compounds structured engineering knowledge inside your own infrastructure.

It does not replace your AI assistant. It makes it reliable at scale.

πŸ“„ Whitepaper (PDF) β€” Vision, architecture, and design in depth.


βš™οΈ Key Technical Features

Flaiwheel is a self-contained Docker service that operates on three levels: Pull β€” agents search before they code (search_docs, get_file_context)
Push β€” agents document as they work (write_bugfix_summary, write_architecture_doc, …)
Capture β€” git commits auto-capture knowledge via a post-commit hook, even without an AI agent

  • Indexes your project documentation (.md, .pdf, .html, .docx, .rst, .txt, .json, .yaml, .csv) into a vector database
  • Provides an MCP server that AI agents (Cursor, Claude Code, VS Code Copilot) connect to
  • Hybrid search β€” combines semantic vector search with BM25 keyword search via Reciprocal Rank Fusion (RRF) for best-of-both-worlds retrieval
  • Cross-encoder reranker β€” optional reranking step that rescores candidates with a cross-encoder model for significantly higher precision on vocabulary-mismatch queries
  • Behavioral Directives β€” AI agents silently search Flaiwheel before every response, auto-document after every task, and reuse before recreating β€” all without being asked
  • get_file_context(filename) β€” pre-loads spatial knowledge for any file the agent is about to edit (complements get_recent_sessions for full temporal + spatial context)
  • post-commit git hook β€” captures every fix:, feat:, refactor:, perf:, docs: commit as a structured knowledge doc automatically
  • Living Architecture β€” AI agents are instructed to maintain self-updating Mermaid.js diagrams for system components and flows
  • Executable Test Flows β€” test scenarios are documented in machine-readable BDD/Gherkin format (Given, When, Then) for QA automation
  • Learns from bugfixes β€” agents write bugfix summaries that are instantly indexed
  • Structured write tools β€” 7 category-specific tools (bugfix, architecture, API, best-practice, setup, changelog, test case) that enforce quality at the source
  • Structured relations (v1) β€” relations() and timeline() derive a per-project knowledge graph from optional YAML frontmatter on existing docs (id, replaces, depends_on, fixes, implements, status). No second store β€” markdown stays canonical and Git history is the validity window
  • Pre-commit validation β€” validate_doc() checks freeform markdown before it enters the knowledge base, including unknown-relation-key warnings
  • Ingest quality gate β€” files with critical issues are automatically skipped during indexing (never deleted β€” you own your files)
  • Auto-syncs via Git β€” pulls AND pushes to a dedicated knowledge repo
  • Tool telemetry (persistent) β€” tracks every MCP call per project (searches, writes, misses, patterns), detects knowledge gaps, and nudges agents to document β€” persisted across restarts and visible in the Web UI
  • Impact metrics API β€” /api/impact-metrics computes estimated time saved + regressions avoided; CI pipelines can post guardrail outcomes to /api/telemetry/ci-guardrail-report
  • Proactive quality checks β€” automatically validates knowledge base after every reindex
  • Knowledge Bootstrap β€” "This is the Way": analyse messy repos, classify files, detect duplicates, propose a cleanup plan, execute with user approval (never deletes files)
  • Cold-Start Codebase Analyzer β€” analyze_codebase(path) scans a source code directory entirely server-side (zero tokens, zero cloud). Uses Python's built-in ast module for Python, regex for TypeScript/JavaScript, the existing MiniLM embedding model for classification and duplicate detection. Returns a single bootstrap_report.md with language distribution, category map, top 20 files to document first ranked by documentability score, duplicate pairs, and coverage gaps. Reduces cold-start token cost by ~90% on legacy codebases.
  • Multi-project support β€” one container manages multiple knowledge repos with per-project isolation
  • Includes a Web UI for configuration, monitoring, and testing

What’s New in v3.13.0 β€” Observability

  • Flaiwheel now knows whether its knowledge repo is still connected to its remote. Everything before this reported on pushes that were attempted. The failure that hid 325 documents in a Docker volume for 2.5 months attempted nothing: the clone had drifted from its remote, so there was never anything to commit, so no push could fail, so nothing went red. check_divergence() compares HEAD against @{u} and classifies the result as synced / ahead / behind / diverged / no-upstream.
  • The "nothing to push" path is where this matters. That branch used to return an unconditional "already in sync". It now verifies the claim. Divergence is also checked after every successful push (did the commit actually land?), after a rejected push (a rejection is the classic symptom β€” now named instead of leaving you to read a git error), and on every pull.
  • A repo that indexes perfectly and pushes nothing is no longer "healthy". /health gains divergence_status, commits_ahead, commits_behind and last_divergence_at, and reports degraded on diverged, ahead or no-upstream. Being behind is the normal state between two pulls and deliberately does not alarm.
  • The agent is told directly. write_* results append an explicit warning when the repo has diverged β€” including on "nothing to push". A warning in an endpoint nobody polls does not exist; the agent that just wrote the document is the one that needs to know it never left the machine.
  • Tests: 316 β†’ 335, against real temp repos including a force-pushed rewritten upstream β€” the real-world trigger, where a secret purge or a squash silently desynchronises every clone.
  • This closes the 2026-08-19 incident completely. The one item that looked outstanding β€” "watcher path scoping" β€” was retracted as a misdiagnosis after checking the running container. Its only evidence was the log line knowledge: update flaiwheel/telemetry.json, read as one project's file being committed into all 11 repos. The real path is .flaiwheel/telemetry.json, with a leading dot: the signature of the porcelain off-by-one already fixed in v3.12.2. Every project owns an identically-named telemetry file, so all 11 watchers logged the same mangled string at once β€” uniformity caused by shared code, mistaken for shared state.

Previous: v3.12.3

  • Every dependency is capped below the next major. Eleven requirements were unbounded >=X. That fails silently: the breaking release lands, existing installs keep working off a stale resolve, and it only bites on the next fresh install β€” CI, a Docker rebuild, a new contributor. Exactly how mcp 2.0.0 broke CI and the Docker build together three weeks after release while every dev machine stayed green. A clean install resolves to identical versions as before, so this constrains the future without moving anything today.
  • Sustained push failure now degrades /health. HealthTracker kept only last_push_ok β€” a single boolean the next attempt overwrites β€” so one blip and a repo failing for weeks looked the same. push_failures_consecutive escalates past 3 consecutive failures. A single failure deliberately does not degrade; crying wolf on transients is how alerts get ignored.
  • /health names the failing projects. Adds last_push_ok, last_push_error, push_failures_consecutive and degraded_projects β€” previously the endpoint could say degraded while showing only the default project's numbers, with no way to tell which repo was broken.
  • Pre-deploy image smoke test documented. An image can build cleanly and still fail every import at runtime. The README now verifies from flaiwheel.server import create_mcp_server inside the image before starting a container, and renames rather than removes the previous container so rollback is instant.
  • Tests: 308 β†’ 316.

Read the full README β†’View source on GitHub β†’

Related MCP Servers

View all in Knowledge & Memory View all alternatives
  • Moxie Docs MCP logoMoxie Docs MCP
    β˜… Featured

    MCP & Agent Skills for Automated Documentation, and codebase conventions + context

    🧠 Knowledge & Memory21 views
    Compare vs Moxie Docs MCP β†’
  • Scrivener MCP logoScrivener MCP

    Connect Scrivener 3 writing projects to Claude and other AI assistants. 47 tools for document management, writing analysis, semantic search, character/plot memory, and content enhancement. Progressive skill loading, relationship engine with HMS triplets, and JS fallback for offline semantic search. npm i -g scrivener-mcp

    🧠 Knowledge & Memory16 views
    Compare vs Scrivener MCP β†’
  • Codebase Memory MCP logoCodebase Memory MCP

    Code-intelligence engine that indexes a repo into a persistent knowledge graph β€” functions, classes, call chains, HTTP routes, cross-service links. 159 languages via tree-sitter + Hybrid LSP, sub-ms structural queries, 99% fewer tokens than grep. Single static binary, zero dependencies, 100% local. npx codebase-memory-mcp

    🧠 Knowledge & Memory7 views
    Compare vs Codebase Memory MCP β†’
  • Hindsight logoHindsight

    Hindsight: Agent Memory That Works Like Human Memory - Built for AI Agents to manage Long Term Memory

    🧠 Knowledge & Memory3 views
    Compare vs Hindsight β†’

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks β€” not a rating.

GitHub stars
6
Stargazers on the source repository.
Last commit
22d ago
Most recent push to the default branch.

Reviews

No reviews yet β€” be the first to share how this listing worked for you.

Frequently Asked Questions about Flaiwheel

No, Flaiwheel is fully self-hosted in a single Docker container with zero cloud dependencies.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFlaiwheel AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/dl4rce-flaiwheel?style=directory)](https://allmcps.com/mcp/dl4rce-flaiwheel)
HTML Embed
<a href="https://allmcps.com/mcp/dl4rce-flaiwheel"><img src="https://allmcps.com/api/badge/dl4rce-flaiwheel?style=directory" alt="Flaiwheel on AllMCPs" /></a>

Technical Specs & Signals

Category🧠Knowledge & Memory
More technical detailsExpand β–Ύ
TransportSTDIO
RuntimeNode.js
Last updatedAug 19, 2026
Views0
Unique ViewsTotal visits recorded for this listing page on AllMCPs.
Installs0
Installs & Copy ActionsTotal times users copied install commands or configuration snippets for this server.
GitHub stars6
GitHub Star CountTotal stargazers on GitHub representing community popularity (6 stars).
Last commit22d ago
Last Repository CommitThe most recent commit or push recorded for this server's GitHub repository.Last commit on Aug 19, 2026
51Quality signal: Good Β· 51/100How this signal is calculated β–Ύ
Server availabilityNot measured

Not scored for repo-hosted servers β€” we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20
Documentation & tools23/30
Adoption & activity5/15
Community engagement0/10

A guidance signal from public completeness & health data β€” not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

β˜… FeaturedAllMCPs Server logo

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server β†’

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge β€” proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it β€” no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory β†’Best MCP servers for Memory & Knowledge β†’Alternatives to Flaiwheel β†’Install in Claude DesktopInstall in CursorInstall in VS Code