makeamouse avatar

fish-bridge — Session Knowledge Graph

makeamouse/fish-bridge-mcp

Turns sprawling AI chat sessions into compact knowledge graphs that persist across conversations. The core workflow runs standalone: ingest from Copilot JSONL or paste any chat, compile to a 300-800 token graph, write to copilot-instructions.md or CLAUDE.md. The optional MCP server adds real-time turn recording in VS Code agent mode via record_turn, get_context, mark_resolved, and export_session tools. Supports local Ollama (free, offline) or cloud backends like Gemini and Claude. Useful when you're resuming long-running architecture discussions or onboarding someone mid-project. Also merges external sources like Obsidian vaults, git logs, dependency manifests, and test output into the same typed graph structure.

GitHub stars
1
tools
9
auth
Secret needed
transport
STDIO
env vars
3
last updated
May 17, 2026

Tools

9 tools

Public tool metadata for what this MCP can expose to an agent.

record_turn

No parameter schema in public metadata yet.

get_context

No parameter schema in public metadata yet.

get_focus

No parameter schema in public metadata yet.

mark_resolved

No parameter schema in public metadata yet.

add_node

No parameter schema in public metadata yet.

export_session

No parameter schema in public metadata yet.

import_session

No parameter schema in public metadata yet.

show_active

No parameter schema in public metadata yet.

list_deferred

No parameter schema in public metadata yet.

Sponsors

Configuration

ANTHROPIC_API_KEYsecret

API key for Claude extraction backend (omit when using local/Ollama)

OPENAI_API_KEYsecret

API key for OpenAI extraction backend (omit when using local/Ollama)

GEMINI_API_KEYsecret

API key for Gemini extraction backend (omit when using local/Ollama)

Readme

fish_bridge

CI PyPI Python License: MIT

Session-scoped knowledge graph engine for AI chat context compression.

Converts raw AI chat (40k+ tokens) into a compact typed knowledge graph (~300–800 tokens) and writes it to .github/copilot-instructions.md or CLAUDE.md — automatically included in every AI turn across all modes (ask, edit, agent). No MCP server required for the core workflow.

Raw session (40k tokens) → [fish_bridge] → Compressed graph (350 tokens)
                                              written to copilot-instructions.md
                                              picked up by every AI turn automatically

Install


View the full README on GitHub

Details

Repository
github.com/makeamouse/fish-bridge-mcp
Categories
AI & LLM Tools, Communication & Messaging, Documents & Knowledge
Package
fish-bridge-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1marerem avatarLongmemmarerem/longmemPersistent cross-project memory for Cursor and Claude Code using local semantic search.1stars
2metrxbots avatarMcp Servermetrxbots/mcp-serverTrack AI agent costs, detect waste, optimize models, and prove ROI. 23 MCP tools across 10 domains.0stars
3ndjordjevic avatarPinRAGndjordjevic/pinragMCP RAG: index PDFs, repos, YouTube, Discord, text; optional YouTube vision; query with citations.1stars
4nugehs avatarAiglarenugehs/aiglareAudit AI/LLM features for governance guardrails: confidence, fallback, validation, human-in-loop.1stars
5prompeteer avatarPrompeteerprompeteer/prompeteer-mcpContextual prompts and agent skills for 140+ AI platforms.1stars
6pvliesdonk avatarImage Generation MCP Serverpvliesdonk/image-generation-mcpMCP server for AI image generation via OpenAI, Stable Diffusion (SD WebUI), or placeholders.1stars