How gamosoft/notediscovery works
NoteDiscovery is a self-hosted Markdown knowledge base. Users write and organize notes in the web app, which communicates with the FastAPI backend and stores notes as files; discovery features include search, tags, backlinks, and a knowledge graph. AI clients can also access notes through the MCP server and its HTTP client. The graph preserves README capabilities such as sharing, export, drawing, themes, and plugins. Some feature-specific implementation paths are not shown, so their placement and connections are omitted where evidence is insufficient.
Main entry points: main.py FastAPI application · server.py MCP server · app.js Web app · utils.py File and Markdown utilities
Components 18
Web experience
- Web app
frontend/app.js - Theme management
backend/themes.py
Note services
- FastAPI application
backend/main.py - Markdown storage
- File and Markdown utilities
backend/utils.py - Public sharing
backend/share.py - HTML export
backend/export.py
Note discovery
- Note index
backend/note_index.py - Search and navigation
backend/utils.py - Links and graph
backend/note_index.py
Extensions
- Plugin system
backend/plugins.py - Plugin extensions
plugins
AI integration
- MCP server
mcp_server/server.py - MCP tools
mcp_server/tools.py - HTTP API client
mcp_server/client.py - MCP configuration
mcp_server/config.py
Other components
- User
- AI assistant
Connections 17
- User → Web app: uses
README.md - Web app → FastAPI application: requests data
- FastAPI application → Markdown storage: reads notes
backend/main.py - FastAPI application → File and Markdown utilities: calls
backend/main.py - File and Markdown utilities → Note index: uses extraction
backend/utils.py - FastAPI application → Plugin system: dispatches hooks
backend/main.py - FastAPI application → Search and navigation: serves discovery
backend/main.py - FastAPI application → Links and graph: serves graph
backend/main.py - FastAPI application → Public sharing: handles sharing
backend/main.py - FastAPI application → HTML export: handles export
backend/main.py - FastAPI application → Theme management: serves themes
backend/main.py - Plugin system → Plugin extensions: loads extensions
- AI assistant → MCP server: requests note actions
README.md - MCP server → HTTP API client: calls
mcp_server/server.py - MCP server → MCP tools: uses definitions
mcp_server/server.py - MCP server → MCP configuration: loads settings
mcp_server/server.py - HTTP API client → FastAPI application: sends HTTP requests
mcp_server/client.py