snapmind-mcp 2.0.0__tar.gz

snapmind_mcp-2.0.0/.env.example

@@ -0,0 +1,9 @@
+SNAPMIND_BACKEND_URL=https://roshan123478-snapmind-backend.hf.space
+HF_TOKEN=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
+SUPABASE_ACCESS_TOKEN=
+GEMINI_API_KEY=
+MISTRAL_API_KEY=
+GROQ_API_KEY=
+FIRECRAWL_API_KEY=
+LINGODEV_API_KEY=
+APIFY_API_TOKEN=

snapmind_mcp-2.0.0/.gitignore

@@ -0,0 +1,6 @@
+.env
+**/.env
+__pycache__/
+*.pyc
+node_modules/
+.pytest_cache/

snapmind_mcp-2.0.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: snapmind-mcp
+Version: 2.0.0
+Summary: MCP server exposing the full SnapMind RAG backend capabilities as tools and resources
+Project-URL: Homepage, https://github.com/roshankumar0036singh/SnapMind
+Project-URL: Repository, https://github.com/roshankumar0036singh/SnapMind
+Project-URL: Documentation, https://github.com/roshankumar0036singh/SnapMind/blob/main/mcp-server/README.md
+Author: SnapMind
+License: ISC
+Keywords: ai,knowledge-base,llm,mcp,rag,smithery,vector-search
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: ISC License (ISCL)
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: anyio>=4.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: respx>=0.21.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# SnapMind MCP Server
+
+[![smithery badge](https://smithery.ai/badge/snapmind-mcp)](https://smithery.ai/server/snapmind-mcp)
+
+The SnapMind Model Context Protocol (MCP) server exposes the powerful capabilities of the SnapMind RAG backend to any MCP-compatible client (like Cursor, Claude Desktop, or Antigravity).
+
+Version 2.0 brings a massive expansion from 9 to **18 tools**, deep reasoning agents, knowledge graph visualization, bookmarks, and site management.
+
+## Installation
+
+### Method 1: Using Smithery (Recommended)
+
+To install SnapMind for Claude Desktop or other MCP clients via Smithery:
+
+```bash
+npx -y @smithery/cli install snapmind-mcp --client claude
+```
+
+### Method 2: Manual Installation
+
+1. Clone the repository and navigate to the `mcp-server` directory:
+```bash
+git clone https://github.com/roshankumar0036singh/SnapMind.git
+cd SnapMind/mcp-server
+```
+
+2. Install dependencies:
+```bash
+pip install -e .
+```
+
+3. Add to your MCP client configuration (e.g., `claude_desktop_config.json` or Cursor's MCP config):
+
+```json
+{
+  "mcpServers": {
+    "snapmind": {
+      "command": "snapmind-mcp",
+      "env": {
+        "SNAPMIND_BACKEND_URL": "https://snapmind-gateway.roshankumar30080.workers.dev",
+        "GEMINI_API_KEY": "your-gemini-key",
+        "MISTRAL_API_KEY": "your-mistral-key"
+      }
+    }
+  }
+}
+```
+
+## Features
+
+### 🛠️ 18 Available Tools
+* **Search & Chat**
+  * `snapmind_search` - Semantic search across documents, bookmarks, and history.
+  * `snapmind_chat` - Chat with your knowledge base using optional personas.
+* **Knowledge Management**
+  * `snapmind_create_bookmark` / `list_bookmarks` / `delete_bookmark` - Manage saved snippets.
+  * `snapmind_knowledge_graph` - Extract relations and nodes from your data.
+  * `snapmind_list_sites` / `delete_site` - Manage indexed source websites.
+  * `snapmind_export_site` - Export all data for a specific site.
+* **Deep Research**
+  * `snapmind_web_research` - Multi-agent web research pipeline.
+  * `snapmind_deep_research` - Multi-hop reasoning chain across web and local sources.
+  * `snapmind_generate_report` - Synthesize sessions into a DOCX report.
+* **Ingestion**
+  * `snapmind_ingest_url` - Index a website.
+  * `snapmind_ingest_file` - Index local documents (PDF, DOCX, CSV).
+  * `snapmind_ingest_repo` - Clone and index a GitHub repository.
+* **Utilities**
+  * `snapmind_translate` - Translate text between languages.
+  * `snapmind_analyze_image` - Vision AI (QA/OCR) on local images.
+  * `snapmind_list_personas` / `get_analytics` / `health_check`
+
+### 📚 7 Available Resources
+* `snapmind://kb/stats` - Live knowledge base statistics
+* `snapmind://kb/tags` - All semantic tags
+* `snapmind://kb/sites` - List of all indexed source URLs
+* `snapmind://graph/full` - The full knowledge graph data (JSON)
+* `snapmind://graph/sessions` - List of sessions containing graph data
+* `snapmind://sessions/{id}/history` - Chat history for a specific session
+
+### 🗣️ 6 Prompt Templates
+* `research_topic`, `code_review`, `summarize_notebook`, `deep_dive`, `compare_sources`, `export_knowledge`
+
+## Development & Testing
+
+```bash
+# Run tests
+pip install -e ".[dev]"
+pytest tests/ -v
+```

snapmind_mcp-2.0.0/README.md

@@ -0,0 +1,90 @@
+# SnapMind MCP Server
+
+[![smithery badge](https://smithery.ai/badge/snapmind-mcp)](https://smithery.ai/server/snapmind-mcp)
+
+The SnapMind Model Context Protocol (MCP) server exposes the powerful capabilities of the SnapMind RAG backend to any MCP-compatible client (like Cursor, Claude Desktop, or Antigravity).
+
+Version 2.0 brings a massive expansion from 9 to **18 tools**, deep reasoning agents, knowledge graph visualization, bookmarks, and site management.
+
+## Installation
+
+### Method 1: Using Smithery (Recommended)
+
+To install SnapMind for Claude Desktop or other MCP clients via Smithery:
+
+```bash
+npx -y @smithery/cli install snapmind-mcp --client claude
+```
+
+### Method 2: Manual Installation
+
+1. Clone the repository and navigate to the `mcp-server` directory:
+```bash
+git clone https://github.com/roshankumar0036singh/SnapMind.git
+cd SnapMind/mcp-server
+```
+
+2. Install dependencies:
+```bash
+pip install -e .
+```
+
+3. Add to your MCP client configuration (e.g., `claude_desktop_config.json` or Cursor's MCP config):
+
+```json
+{
+  "mcpServers": {
+    "snapmind": {
+      "command": "snapmind-mcp",
+      "env": {
+        "SNAPMIND_BACKEND_URL": "https://snapmind-gateway.roshankumar30080.workers.dev",
+        "GEMINI_API_KEY": "your-gemini-key",
+        "MISTRAL_API_KEY": "your-mistral-key"
+      }
+    }
+  }
+}
+```
+
+## Features
+
+### 🛠️ 18 Available Tools
+* **Search & Chat**
+  * `snapmind_search` - Semantic search across documents, bookmarks, and history.
+  * `snapmind_chat` - Chat with your knowledge base using optional personas.
+* **Knowledge Management**
+  * `snapmind_create_bookmark` / `list_bookmarks` / `delete_bookmark` - Manage saved snippets.
+  * `snapmind_knowledge_graph` - Extract relations and nodes from your data.
+  * `snapmind_list_sites` / `delete_site` - Manage indexed source websites.
+  * `snapmind_export_site` - Export all data for a specific site.
+* **Deep Research**
+  * `snapmind_web_research` - Multi-agent web research pipeline.
+  * `snapmind_deep_research` - Multi-hop reasoning chain across web and local sources.
+  * `snapmind_generate_report` - Synthesize sessions into a DOCX report.
+* **Ingestion**
+  * `snapmind_ingest_url` - Index a website.
+  * `snapmind_ingest_file` - Index local documents (PDF, DOCX, CSV).
+  * `snapmind_ingest_repo` - Clone and index a GitHub repository.
+* **Utilities**
+  * `snapmind_translate` - Translate text between languages.
+  * `snapmind_analyze_image` - Vision AI (QA/OCR) on local images.
+  * `snapmind_list_personas` / `get_analytics` / `health_check`
+
+### 📚 7 Available Resources
+* `snapmind://kb/stats` - Live knowledge base statistics
+* `snapmind://kb/tags` - All semantic tags
+* `snapmind://kb/sites` - List of all indexed source URLs
+* `snapmind://graph/full` - The full knowledge graph data (JSON)
+* `snapmind://graph/sessions` - List of sessions containing graph data
+* `snapmind://sessions/{id}/history` - Chat history for a specific session
+
+### 🗣️ 6 Prompt Templates
+* `research_topic`, `code_review`, `summarize_notebook`, `deep_dive`, `compare_sources`, `export_knowledge`
+
+## Development & Testing
+
+```bash
+# Run tests
+pip install -e ".[dev]"
+pytest tests/ -v
+```

snapmind_mcp-2.0.0/pyproject.toml

@@ -0,0 +1,43 @@
+[project]
+name = "snapmind-mcp"
+version = "2.0.0"
+description = "MCP server exposing the full SnapMind RAG backend capabilities as tools and resources"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "SnapMind" }]
+license = { text = "ISC" }
+keywords = ["mcp", "rag", "ai", "llm", "knowledge-base", "vector-search", "smithery"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: ISC License (ISCL)",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+    "python-dotenv>=1.0.0",
+    "anyio>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/roshankumar0036singh/SnapMind"
+Repository = "https://github.com/roshankumar0036singh/SnapMind"
+Documentation = "https://github.com/roshankumar0036singh/SnapMind/blob/main/mcp-server/README.md"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "respx>=0.21.0",
+]
+
+[project.scripts]
+snapmind-mcp = "snapmind_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

snapmind_mcp-2.0.0/src/snapmind_mcp/config.py

@@ -0,0 +1,50 @@
+import os
+from dotenv import load_dotenv
+import httpx
+from contextlib import asynccontextmanager
+
+load_dotenv()
+
+# The MCP client (Antigravity/Cursor/etc.) provides these in the "env" section of the MCP config
+BACKEND_URL = os.environ.get("SNAPMIND_BACKEND_URL", "https://snapmind-gateway.roshankumar30080.workers.dev").rstrip("/")
+API_PREFIX = "/api/v1"
+
+# Provider Keys (expected from client env)
+API_KEYS = {
+    "gemini": os.environ.get("GEMINI_API_KEY"),
+    "mistral": os.environ.get("MISTRAL_API_KEY"),
+    "groq": os.environ.get("GROQ_API_KEY"),
+    "firecrawl": os.environ.get("FIRECRAWL_API_KEY"),
+    "lingodev": os.environ.get("LINGODEV_API_KEY"),
+    "apify": os.environ.get("APIFY_API_TOKEN"),
+}
+
+# Shared HTTP client for connection pooling
+_client = None
+
+def get_headers():
+    headers = {
+        "Content-Type": "application/json",
+    }
+    
+    # Map to the backend's expected headers
+    if API_KEYS["gemini"]: headers["x-gemini-key"] = API_KEYS["gemini"]
+    if API_KEYS["mistral"]: headers["x-mistral-key"] = API_KEYS["mistral"]
+    if API_KEYS["lingodev"]: headers["x-lingodev-key"] = API_KEYS["lingodev"]
+    if API_KEYS["firecrawl"]: headers["x-firecrawl-key"] = API_KEYS["firecrawl"]
+    if API_KEYS["groq"]: headers["x-groq-key"] = API_KEYS["groq"]
+    if API_KEYS["apify"]: headers["x-apify-token"] = API_KEYS["apify"]
+    
+    return headers
+
+@asynccontextmanager
+async def get_client(timeout: float = 60.0):
+    global _client
+    if _client is None or _client.is_closed:
+        _client = httpx.AsyncClient(timeout=timeout)
+    yield _client
+
+async def close_client():
+    global _client
+    if _client and not _client.is_closed:
+        await _client.aclose()

snapmind_mcp-2.0.0/src/snapmind_mcp/resources/graph.py

@@ -0,0 +1,18 @@
+"""
+SnapMind MCP Resources — Graph
+Implements snapmind://graph/full and snapmind://graph/sessions
+"""
+from snapmind_mcp.config import BACKEND_URL, API_PREFIX, get_headers, get_client
+
+
+async def read_graph_full() -> str:
+    """Fetch the full knowledge graph data."""
+    async with get_client(timeout=30.0) as client:
+        resp = await client.get(f"{BACKEND_URL}{API_PREFIX}/graph/data", headers=get_headers())
+        return resp.text
+
+async def read_graph_sessions() -> str:
+    """Fetch all sessions that have graph data."""
+    async with get_client(timeout=15.0) as client:
+        resp = await client.get(f"{BACKEND_URL}{API_PREFIX}/graph/sessions", headers=get_headers())
+        return resp.text

snapmind_mcp-2.0.0/src/snapmind_mcp/resources/kb.py

@@ -0,0 +1,25 @@
+"""
+SnapMind MCP Resources — Knowledge Base
+Implements snapmind://kb/stats, snapmind://kb/tags, snapmind://kb/sites
+"""
+from snapmind_mcp.config import BACKEND_URL, API_PREFIX, get_headers, get_client
+
+
+async def read_kb_stats() -> str:
+    """Fetch live knowledge base statistics."""
+    async with get_client(timeout=15.0) as client:
+        resp = await client.get(f"{BACKEND_URL}{API_PREFIX}/admin/analytics", headers=get_headers())
+        return resp.text
+
+
+async def read_kb_tags() -> str:
+    """Fetch all semantic tags from the knowledge base."""
+    async with get_client(timeout=15.0) as client:
+        resp = await client.get(f"{BACKEND_URL}{API_PREFIX}/tags", headers=get_headers())
+        return resp.text
+
+async def read_kb_sites() -> str:
+    """Fetch all indexed sites."""
+    async with get_client(timeout=15.0) as client:
+        resp = await client.get(f"{BACKEND_URL}{API_PREFIX}/sites", headers=get_headers())
+        return resp.text

snapmind_mcp-2.0.0/src/snapmind_mcp/resources/sessions.py

@@ -0,0 +1,21 @@
+"""
+SnapMind MCP Resources — Session History
+Implements snapmind://sessions/{id}/history resource.
+"""
+from snapmind_mcp.config import BACKEND_URL, API_PREFIX, get_headers, get_client
+
+
+async def read_session_history(session_id: str) -> str:
+    """Fetch chat history for a specific session."""
+    async with get_client(timeout=15.0) as client:
+        resp = await client.get(
+            f"{BACKEND_URL}{API_PREFIX}/search/sessions/{session_id}", # Assuming it's under search or similar now, fallback logic below
+            headers=get_headers()
+        )
+        if resp.status_code == 404:
+             # Try old route or workspaces route just in case
+             resp = await client.get(
+                 f"{BACKEND_URL}{API_PREFIX}/workspaces/sessions/{session_id}",
+                 headers=get_headers()
+             )
+        return resp.text