Skip to main content
Glama
Sign In
mycelium

mycelium

by Transmitt0r
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

mycelium

Shared toolkit for building agent plugins over personal knowledge sources (documents, notes, and whatever comes next) — extracted out of the OpenClaw plugins for paperless-ngx and Trilium Notes, which had independently grown near-identical semantic search implementations. Those plugins — plus the 1Password secret-provider plugin — now live in this same repo (apps/paperless-ngx, apps/trilium, apps/onepassword), so they can consume the shared packages below as ordinary workspace dependencies instead of a publish-then-consume round trip across separate repos. Each still publishes to npm independently, under its own name.

Three problems, three packages:

Package

Problem it solves

@transmitt0r/mycelium-embed

"I want to use any LLM for embeddings/retrieval, not just one hardcoded provider." Pluggable client for any OpenAI-compatible endpoint (OpenAI, OpenRouter, Ollama, vLLM, LM Studio, ...), plus an opt-in local CPU fallback with zero API dependency.

@transmitt0r/mycelium-index

"I want semantic search over my personal document/note corpus without running a vector DB server." A local, file-backed sqlite-vec index with incremental sync and hybrid lexical+semantic search (Reciprocal Rank Fusion).

@transmitt0r/mycelium-mcp

"I want my plugin's tools usable outside one specific agent host." Bridges the same tool definitions onto a standalone MCP server, over stdio and Streamable HTTP.

Plus @transmitt0r/mycelium-tooling-config: shared biome/tsconfig presets, and @transmitt0r/mycelium-openapi-codegen: shared OpenAPI-schema-to-types codegen logic used by the plugin apps' own generator scripts. Both published, but enablers rather than features in their own right.

Why "mycelium"

The fungal network that links otherwise-separate organisms and moves nutrients between them — which is the job here: linking separate personal-data sources to any LLM provider, over any transport, without each plugin reinventing the same wiring.

Related MCP server: ragi

Development

pnpm workspaces, TypeScript 7, Biome for lint/format, Changesets for versioning and releasing the core/*/tools/* packages. Node only, deliberately — see AGENTS.md for why this isn't Bun.

pnpm install
pnpm run build
pnpm run lint
pnpm run test

See AGENTS.md for repo layout and conventions.

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • ragi

    SusuTawar
    A
    license
    A
    quality
    D
    maintenance
    Local-first RAG indexing and semantic search MCP server. Enables document retrieval and context-aware queries using local embedding models.
    3
    14 npm
    MIT

  • RAG MCP Server

    alejandro-ao
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides tools for ingesting documents into a local vector database and retrieving relevant information via semantic search, enabling retrieval-augmented generation for MCP clients.
    6
    -