solograph 0.1.0__tar.gz

solograph-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+dist/
+build/
+.codegraph/
+.embeddings/

solograph-0.1.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: solograph
+Version: 0.1.0
+Summary: Code intelligence MCP server — multi-project code graph, semantic search, session history, knowledge base, web search
+Author: Rustam Salavatov
+License-Expression: MIT
+Keywords: claude-code,code-intelligence,codegraph,mcp,semantic-search,solograph
+Requires-Python: <3.14,>=3.13
+Requires-Dist: click>=8.1
+Requires-Dist: falkordblite>=0.4
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: mcp>=1.26.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: python-frontmatter>=1.1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: semantic-text-splitter>=0.29.0
+Requires-Dist: sentence-transformers>=5.2.2
+Requires-Dist: tree-sitter-kotlin>=1.0
+Requires-Dist: tree-sitter-python>=0.23
+Requires-Dist: tree-sitter-swift>=0.0.1
+Requires-Dist: tree-sitter-typescript>=0.23
+Requires-Dist: tree-sitter>=0.24
+Provides-Extra: dev
+Requires-Dist: pre-commit>=4.5.1; extra == 'dev'
+Provides-Extra: mlx
+Requires-Dist: mlx-embeddings>=0.0.3; extra == 'mlx'
+Description-Content-Type: text/markdown
+
+# solograph
+
+Code intelligence MCP server for Claude Code. Multi-project code graph, semantic search, session history, knowledge base, web search.
+
+> PyPI: `pip install solograph` / `uvx solograph`
+
+All vector search powered by **FalkorDB** (embedded, no Docker). No ChromaDB dependency.
+
+## Embeddings
+
+Two backends, both produce **384-dimensional** vectors:
+
+| Backend | Model | Platform | Languages |
+|---------|-------|----------|-----------|
+| **MLX** (primary) | `multilingual-e5-small-mlx` | Apple Silicon | RU + EN |
+| **sentence-transformers** (fallback) | `all-MiniLM-L6-v2` | Any | EN |
+
+Auto-detects Apple Silicon → uses MLX. Falls back to sentence-transformers on other platforms.
+
+Install MLX support (optional):
+```bash
+uv add solograph[mlx]
+```
+
+## Install
+
+```bash
+uv add solograph
+# or
+pip install solograph
+```
+
+## Usage
+
+### MCP Server (for Claude Code)
+
+Add to `.mcp.json`:
+```json
+{
+  "mcpServers": {
+    "codegraph": {
+      "command": "uvx",
+      "args": ["solograph"]
+    }
+  }
+}
+```
+
+### CLI
+
+```bash
+codegraph scan              # Build code graph
+codegraph stats             # Graph statistics
+codegraph explain my-app    # Architecture overview
+codegraph query "MATCH ..." # Raw Cypher
+```
+
+## Configuration
+
+Environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `CODEGRAPH_DB_PATH` | `~/.codegraph/codegraph.db` | FalkorDB code graph path |
+| `CODEGRAPH_REGISTRY` | auto-detect | registry.yaml path |
+| `KB_PATH` | (none) | Knowledge base root (markdown files with YAML frontmatter) |
+| `TAVILY_API_URL` | `http://localhost:8013` | Tavily-compatible search URL |
+| `TAVILY_API_KEY` | (none) | API key for Tavily |
+
+## 11 MCP Tools
+
+- `codegraph_query` — Cypher queries against code graph
+- `codegraph_stats` — graph statistics (projects, files, symbols, packages)
+- `codegraph_explain` — architecture overview of a project
+- `codegraph_shared` — packages shared across projects
+- `project_code_search` — semantic code search (auto-indexes on first call)
+- `project_code_reindex` — reindex project code into FalkorDB vectors
+- `session_search` — Claude Code session history search
+- `project_info` — project registry info
+- `kb_search` — knowledge base semantic search
+- `web_search` — web search (Tavily/SearXNG)
+
+## Web Search
+
+The `web_search` tool connects to any **Tavily-compatible API**. Works great with self-hosted [SearXNG + Tavily Adapter](https://github.com/fortunto2/searxng-docker-tavily-adapter) — private, no API keys, smart engine routing.
+
+```bash
+# Self-hosted (Docker, 1 minute setup)
+git clone https://github.com/fortunto2/searxng-docker-tavily-adapter.git
+cd searxng-docker-tavily-adapter
+cp config.example.yaml config.yaml
+docker compose up -d
+# → http://localhost:8013/search (Tavily API)
+# → http://localhost:8999 (SearXNG UI)
+```
+
+Or use [Tavily API](https://tavily.com) directly — set `TAVILY_API_URL=https://api.tavily.com` and `TAVILY_API_KEY`.
+
+Smart engine routing auto-selects search engines by query type:
+- **tech**: github, stackoverflow (keywords: python, react, code)
+- **academic**: arxiv, google scholar (keywords: research, paper)
+- **product**: brave, reddit, app stores (keywords: app, competitor, pricing)
+- **news**: google news (keywords: news, latest, trend)
+- **general**: google, duckduckgo, brave (default)
+
+## Storage
+
+- **Code graph:** `~/.codegraph/codegraph.db` (FalkorDB)
+- **Session vectors:** `~/.codegraph/sessions_vectors/graph.db` (FalkorDB)
+- **KB vectors:** `{KB_PATH}/.codegraph/kb/graph.db` (FalkorDB)
+- **Project vectors:** `{project_path}/.codegraph/falkordb/graph.db` (per-project FalkorDB)
+
+## License
+
+MIT

solograph-0.1.0/README.md

@@ -0,0 +1,115 @@
+# solograph
+
+Code intelligence MCP server for Claude Code. Multi-project code graph, semantic search, session history, knowledge base, web search.
+
+> PyPI: `pip install solograph` / `uvx solograph`
+
+All vector search powered by **FalkorDB** (embedded, no Docker). No ChromaDB dependency.
+
+## Embeddings
+
+Two backends, both produce **384-dimensional** vectors:
+
+| Backend | Model | Platform | Languages |
+|---------|-------|----------|-----------|
+| **MLX** (primary) | `multilingual-e5-small-mlx` | Apple Silicon | RU + EN |
+| **sentence-transformers** (fallback) | `all-MiniLM-L6-v2` | Any | EN |
+
+Auto-detects Apple Silicon → uses MLX. Falls back to sentence-transformers on other platforms.
+
+Install MLX support (optional):
+```bash
+uv add solograph[mlx]
+```
+
+## Install
+
+```bash
+uv add solograph
+# or
+pip install solograph
+```
+
+## Usage
+
+### MCP Server (for Claude Code)
+
+Add to `.mcp.json`:
+```json
+{
+  "mcpServers": {
+    "codegraph": {
+      "command": "uvx",
+      "args": ["solograph"]
+    }
+  }
+}
+```
+
+### CLI
+
+```bash
+codegraph scan              # Build code graph
+codegraph stats             # Graph statistics
+codegraph explain my-app    # Architecture overview
+codegraph query "MATCH ..." # Raw Cypher
+```
+
+## Configuration
+
+Environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `CODEGRAPH_DB_PATH` | `~/.codegraph/codegraph.db` | FalkorDB code graph path |
+| `CODEGRAPH_REGISTRY` | auto-detect | registry.yaml path |
+| `KB_PATH` | (none) | Knowledge base root (markdown files with YAML frontmatter) |
+| `TAVILY_API_URL` | `http://localhost:8013` | Tavily-compatible search URL |
+| `TAVILY_API_KEY` | (none) | API key for Tavily |
+
+## 11 MCP Tools
+
+- `codegraph_query` — Cypher queries against code graph
+- `codegraph_stats` — graph statistics (projects, files, symbols, packages)
+- `codegraph_explain` — architecture overview of a project
+- `codegraph_shared` — packages shared across projects
+- `project_code_search` — semantic code search (auto-indexes on first call)
+- `project_code_reindex` — reindex project code into FalkorDB vectors
+- `session_search` — Claude Code session history search
+- `project_info` — project registry info
+- `kb_search` — knowledge base semantic search
+- `web_search` — web search (Tavily/SearXNG)
+
+## Web Search
+
+The `web_search` tool connects to any **Tavily-compatible API**. Works great with self-hosted [SearXNG + Tavily Adapter](https://github.com/fortunto2/searxng-docker-tavily-adapter) — private, no API keys, smart engine routing.
+
+```bash
+# Self-hosted (Docker, 1 minute setup)
+git clone https://github.com/fortunto2/searxng-docker-tavily-adapter.git
+cd searxng-docker-tavily-adapter
+cp config.example.yaml config.yaml
+docker compose up -d
+# → http://localhost:8013/search (Tavily API)
+# → http://localhost:8999 (SearXNG UI)
+```
+
+Or use [Tavily API](https://tavily.com) directly — set `TAVILY_API_URL=https://api.tavily.com` and `TAVILY_API_KEY`.
+
+Smart engine routing auto-selects search engines by query type:
+- **tech**: github, stackoverflow (keywords: python, react, code)
+- **academic**: arxiv, google scholar (keywords: research, paper)
+- **product**: brave, reddit, app stores (keywords: app, competitor, pricing)
+- **news**: google news (keywords: news, latest, trend)
+- **general**: google, duckduckgo, brave (default)
+
+## Storage
+
+- **Code graph:** `~/.codegraph/codegraph.db` (FalkorDB)
+- **Session vectors:** `~/.codegraph/sessions_vectors/graph.db` (FalkorDB)
+- **KB vectors:** `{KB_PATH}/.codegraph/kb/graph.db` (FalkorDB)
+- **Project vectors:** `{project_path}/.codegraph/falkordb/graph.db` (per-project FalkorDB)
+
+## License
+
+MIT

solograph-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "solograph"
+version = "0.1.0"
+description = "Code intelligence MCP server — multi-project code graph, semantic search, session history, knowledge base, web search"
+readme = "README.md"
+requires-python = ">=3.13,<3.14"
+license = "MIT"
+authors = [
+    { name = "Rustam Salavatov" },
+]
+keywords = ["mcp", "code-intelligence", "codegraph", "semantic-search", "claude-code", "solograph"]
+
+dependencies = [
+    # Graph Database + Vector Search
+    "falkordblite>=0.4",
+    # Embeddings
+    "sentence-transformers>=5.2.2",
+    "semantic-text-splitter>=0.29.0",
+    # Code Analysis
+    "tree-sitter>=0.24",
+    "tree-sitter-python>=0.23",
+    "tree-sitter-swift>=0.0.1",
+    "tree-sitter-typescript>=0.23",
+    "tree-sitter-kotlin>=1.0",
+    # Schema & Config
+    "pydantic>=2.12.5",
+    "pyyaml>=6.0",
+    "python-frontmatter>=1.1.0",
+    # CLI & Output
+    "click>=8.1",
+    "rich>=13.0.0",
+    # MCP
+    "mcp>=1.26.0",
+    # HTTP (web search)
+    "httpx>=0.28.1",
+]
+
+[project.optional-dependencies]
+mlx = ["mlx-embeddings>=0.0.3"]
+dev = ["pre-commit>=4.5.1"]
+
+[project.scripts]
+codegraph = "codegraph_mcp.cli:cli"
+solograph = "codegraph_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/codegraph_mcp"]

solograph-0.1.0/src/codegraph_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""CodeGraph MCP — code intelligence server for Claude Code."""
+
+__version__ = "0.1.0"

solograph-0.1.0/src/codegraph_mcp/__main__.py

@@ -0,0 +1,4 @@
+"""Allow running as: python -m codegraph_mcp"""
+from .cli import cli
+
+cli()