{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_y3k2j6y23p82","handle":"mcp-trove-crunchtools","url":"https://wellknown.network/agents/mcp-trove-crunchtools","links":{"self":"https://wellknown.network/agents/mcp-trove-crunchtools/record.json","html":"https://wellknown.network/agents/mcp-trove-crunchtools","markdown":"https://wellknown.network/agents/mcp-trove-crunchtools/record.md","api":"https://wellknown.network/api/v1/agents/mcp-trove-crunchtools","status":"https://wellknown.network/api/v1/agents/mcp-trove-crunchtools/status","claim":"https://wellknown.network/agents/mcp-trove-crunchtools/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-trove-crunchtools/claim.json","badge":"https://wellknown.network/agents/mcp-trove-crunchtools/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-trove-crunchtools/history","tools":"https://wellknown.network/api/v1/agents/mcp-trove-crunchtools/tools"},"ard":{"identifier":"urn:air::server:mcp-trove-crunchtools","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-trove-crunchtools","summary":"Self-hosted local file indexing MCP server with semantic search","description":"# mcp-trove-crunchtools\n\nSelf-hosted local file indexing MCP server with semantic search. Index any local directory (pCloud ~/AutoSync/, rclone mounts, ~/Documents/, anything) and search over the contents using hybrid vector + keyword search.\n\n## Features\n\n- **Hybrid search** — Combines semantic vector similarity with FTS5 keyword matching\n- **Content categories** — images and videos (captioned), PDF, text, documents (DOCX, DOC, ODT, RTF), spreadsheets (XLSX, XLS, ODS, CSV) and presentations (PPTX, ODP) by default; web pages, data files and source code on request. Every other file can still be found by its name\n- **Local-first** — No cloud services, no per-seat fees, your data stays on your machine\n- **Lightweight embeddings** — Uses fastembed (ONNX runtime) instead of PyTorch (~22MB vs ~2GB)\n- **Incremental indexing** — SHA-256 checksum-based change detection\n- **Background mode** — `--index` CLI mode for systemd timer automation\n\n## Install\n\n### uvx (recommended)\n\n```bash\nuvx mcp-trove-crunchtools\n```\n\n### pip\n\n```bash\npip install mcp-trove-crunchtools\n```\n\n### Container\n\n```bash\npodman run -v trove-data:/data -v ~/Documents:/docs:ro quay.io/crunchtools/mcp-trove\n```\n\n## Claude Code Integration\n\n```bash\nclaude mcp add mcp-trove-crunchtools -- uvx mcp-trove-crunchtools\n```\n\n## Tools (10)\n\n### Search (2)\n\n| Tool | Description |\n|------|-------------|\n| `trove_search` | Hybrid search: vector similarity, keywords (bm25) and folder/file names, fused by rank. One result per file, its best chunk, with `score`, `sources` and `matches`. `path` scopes it to a path prefix. |\n| `trove_similar` | Find files similar to a given indexed file using its average embedding. |\n\n### Index Management (3)\n\n| Tool | Description |\n|------|-------------|\n| `trove_index` | Index a specific file or directory. Skips unchanged files (checksum-based). |\n| `trove_reindex` | Force re-index ignoring checksums. If no path given, reindexes everything. |\n| `trove_remove` | Remove a file or directory …","publisher":{"name":"crunchtools.com","url":null},"homepage":null,"repository":null,"version":"1.0.7","license":null,"protocols":["mcp"],"tags":["embeddings","mcp","rag","semantic-search","sqlite"],"pricing":null,"endpoints":[{"url":"pypi:mcp-trove-crunchtools","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":1,"provenance":"derived"},{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"declared"},{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"},{"slug":"documents.presentations","name":"Presentations","confidence":0.825,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["data","dev","documents"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-trove-crunchtools","registry":"pypi","observedAt":"2026-11-03T17:25:52.773Z","publishedAt":"2026-10-31T23:06:24.584130Z","latestVersion":"1.0.7"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-trove-crunchtools","url":"https://pypi.org/project/mcp-trove-crunchtools/","firstSeenAt":"2026-09-10T05:21:31.707Z","fetchedAt":"2026-11-03T17:23:54.679Z","normalizedAt":"2026-11-03T17:23:54.679Z"}]},"firstSeenAt":"2026-09-10T05:21:31.707Z","updatedAt":"2026-11-03T17:25:52.773Z"}