{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_rsbbqrhaarc7","handle":"astroid-mcp","url":"https://wellknown.network/agents/astroid-mcp","links":{"self":"https://wellknown.network/agents/astroid-mcp/record.json","html":"https://wellknown.network/agents/astroid-mcp","markdown":"https://wellknown.network/agents/astroid-mcp/record.md","api":"https://wellknown.network/api/v1/agents/astroid-mcp","status":"https://wellknown.network/api/v1/agents/astroid-mcp/status","claim":"https://wellknown.network/agents/astroid-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/astroid-mcp/claim.json","badge":"https://wellknown.network/agents/astroid-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/astroid-mcp/history","tools":"https://wellknown.network/api/v1/agents/astroid-mcp/tools"},"ard":{"identifier":"urn:air::server:astroid-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"astroid-mcp","summary":"High-performance, local FastEmbed vector MCP server for Astro documentation","description":"# Astroid (astroid-mcp)\n\nHigh-performance, local FastEmbed ONNX vector + SQLite FTS5 Model Context\nProtocol (MCP) server for Astro documentation.\n\n- **Hybrid search**: 384-dim BAAI/bge-small-en-v1.5 embeddings + SQLite FTS5\n  BM25, fixed candidate pools, deterministic rankings.\n- **Clean chunks**: heading-aware splitting, tiny-section merging, cross-doc\n  dedupe; every chunk fully inside the model's 512-token window (zero silent\n  truncation).\n- **Native stdio**: local execution, zero network ports.\n- **Additive-only installer**: never rewrites your existing MCPs or settings.\n\n## Install (Windows and WSL — same package, simultaneously)\n\nOne wheel (`py3-none-any`) serves both OSes. Install it as an *application*\nso the `astroid` command lands on PATH: `pipx install` or `uv tool install`.\nPlain `pip install` / `uv pip install` only drops the library into a Python\nenvironment (no command on PATH) — if you went that way by habit and get\n`astroid: command not found`, reinstall with one of the two below.\n\nWhat `astroid install` does — all three, every time:\n\n1. Registers the server in the global OpenCode config (one additive entry;\n   sibling MCPs, comments, and formatting are preserved).\n2. Copies the prebuilt docs database into the per-OS user path\n   (see table below). An existing database is left byte-identical.\n3. Downloads the embedding model (~70 MB, once per OS — shared with other\n   MCPs using the same model) into the per-OS model cache (see table below).\n\nOffline? The config entry still applies; the data steps print a skip line\nand happen on the first search instead — so the first answer is the slow\none, never the install.\n\nWindows (PowerShell):\n\n```powershell\npipx install astroid-mcp\n# or: uv tool install astroid-mcp\nastroid install\nastroid search \"routing\" --limit 1   # verify: expect routing docs back\n```\n\nWSL / Linux (bash). The `export` line is one-time setup — persist it so\nevery new shell finds the command:\n\n```bash\nuv tool install astroid-mcp\n# or: pipx…","publisher":{"name":"Nitin","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:astroid-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":0.825,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.802,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["data","dev"],"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":"astroid-mcp","registry":"pypi","observedAt":"2026-11-08T23:27:43.147Z","publishedAt":"2026-09-07T08:27:29.017017Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"astroid-mcp","url":"https://pypi.org/project/astroid-mcp/","firstSeenAt":"2026-09-09T09:24:02.773Z","fetchedAt":"2026-11-08T23:26:48.430Z","normalizedAt":"2026-11-08T23:26:48.430Z"}]},"firstSeenAt":"2026-09-09T09:24:02.773Z","updatedAt":"2026-11-08T23:27:43.147Z"}