context-server 0.1.4__py3-none-macosx_11_0_arm64.whl

context_server-0.1.4.dist-info/METADATA

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: context-server
+Version: 0.1.4
+License-File: LICENSE
+Summary: Lightweight MCP server for semantic search over organizational markdown
+Home-Page: https://github.com/shanemcd/context-server
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Repository, https://github.com/shanemcd/context-server
+
+# context-server
+
+A lightweight [MCP](https://modelcontextprotocol.io/) server for **semantic search over markdown knowledge bases**.
+
+One Rust binary. ONNX Runtime is **statically linked** (via [`ort`](https://github.com/pykeio/ort) / [`fastembed`](https://github.com/Anush008/fastembed-rs)) — no separate `libonnxruntime.so` to ship. SQLite is bundled. Built for AI coding agents (Claude Code, Cursor, etc.).
+
+## Features
+
+- Index markdown into a local SQLite vector database
+- Chunk by `##` / `###` headings (hierarchy kept in each chunk)
+- Semantic search with All-MiniLM-L6-v2 (384-dim)
+- MCP tools: `semantic_search`, `list_documents`, `answer_question`
+- CLI for index / search / embed smoke tests
+
+**Input contract:** feed searchable prose (markdown). Structured data (YAML, etc.) should be converted to markdown *before* indexing — raw YAML in code fences searches poorly.
+
+## Requirements
+
+- Rust 1.75+ (edition 2021)
+- Linux x86_64 (primary target today)
+- At build/link time: a C++ standard library (`libstdc++`) and OpenSSL development headers if your platform needs them for `native-tls`
+
+On Fedora/RHEL, if the linker cannot find `-lstdc++` (only `libstdc++.so.6` is installed):
+
+```bash
+mkdir -p .linker && ln -sfn /usr/lib64/libstdc++.so.6 .linker/libstdc++.so
+export RUSTFLAGS="-L native=$(pwd)/.linker"
+```
+
+## Install
+
+```bash
+pip install context-server
+```
+
+Platform wheels: Linux x86_64/aarch64 (`manylinux_2_39`, glibc 2.39+ / Ubuntu 24.04+) and macOS Apple Silicon.
+
+## Build
+
+```bash
+cargo build --release
+```
+
+The first embedding run downloads the MiniLM model into the local Hugging Face / fastembed cache (~tens of MB, once).
+
+### Linux wheels (Podman)
+
+Same Containerfile CI uses (Ubuntu 24.04 / glibc 2.39 — required by current ORT prebuilts):
+
+```bash
+./scripts/build-wheel.sh   # writes dist/*.whl
+```
+
+## Usage
+
+```bash
+# Preview how documents will be chunked
+./target/release/context-server index --input ./docs --dry-run
+
+# Embed and write the database
+./target/release/context-server index --input ./docs --db context.db
+
+# CLI search
+./target/release/context-server search --db context.db "how do we handle backports"
+
+# MCP stdio server
+./target/release/context-server serve --db context.db
+```
+
+### Claude Code
+
+```bash
+claude mcp add --transport stdio --scope user context-server \
+  -- /absolute/path/to/context-server serve --db /absolute/path/to/context.db
+```
+
+Re-index when content changes, then restart the MCP session so `serve` reloads the DB into memory.
+
+## MCP tools
+
+| Tool | Description |
+|------|-------------|
+| `semantic_search` | Ranked passages with similarity scores |
+| `list_documents` | Indexed chunk listing |
+| `answer_question` | Top passage for a question (retrieval only, no generative QA) |
+
+## Architecture
+
+| Piece | Choice |
+|-------|--------|
+| Embeddings | fastembed → All-MiniLM-L6-v2, L2-normalized |
+| Inference | ort (static ONNX Runtime) |
+| Storage | rusqlite (bundled SQLite), float32 blobs |
+| Search | Brute-force cosine (fine for <100K chunks) |
+| MCP | [rmcp](https://github.com/modelcontextprotocol/rust-sdk) stdio |
+
+See [PLAN.md](PLAN.md) for design notes and roadmap.
+
+## Development
+
+```bash
+cargo test
+cargo build --release
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+

context_server-0.1.4.dist-info/RECORD

@@ -0,0 +1,6 @@
+context_server-0.1.4.data/scripts/context-server,sha256=jQunNRQS4hyuhuN8uA8RJhToqaMyO_Py9QVMSKzGLWk,25161728
+context_server-0.1.4.dist-info/METADATA,sha256=Tc2Gf0bNaFQgbkIg9Zp5wwqzeVgVWaTlswyeoI2NZ8Q,3675
+context_server-0.1.4.dist-info/WHEEL,sha256=7m8kjhP_K0tQ6qXK8P1IG2YeRznSaoXUEpeK3IfZx-I,102
+context_server-0.1.4.dist-info/licenses/LICENSE,sha256=GIrjZZgzkQdGJnKC0b2EI_svyzurFL0U6GeuEhDI-CU,1071
+context_server-0.1.4.dist-info/sboms/context-server.cyclonedx.json,sha256=JwyzdMUAp-I64F-LPizWE8NtWjK0VGh3cNHRw7zg-rY,402196
+context_server-0.1.4.dist-info/RECORD,,

context_server-0.1.4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.14.1)
+Root-Is-Purelib: false
+Tag: py3-none-macosx_11_0_arm64

context_server-0.1.4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shane McDonald
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.