mycelium
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 |
"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. | |
"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). | |
"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.
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 testSee AGENTS.md for repo layout and conventions.
License
MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Transmitt0r/mycelium'
If you have feedback or need assistance with the MCP directory API, please join our Discord server