memory-map-mcp 0.1.0__tar.gz

memory_map_mcp-0.1.0/.env.example

@@ -0,0 +1,41 @@
+# ============================================================
+# memory_map — Environment Configuration
+# Copy this file to .env and fill in your values.
+# ============================================================
+
+# ----------------------------------------------------------
+# MongoDB Atlas (required)
+# Create a free cluster at https://cloud.mongodb.com
+# ----------------------------------------------------------
+MEMORY_MAP_MONGO_URI=mongodb+srv://<user>:<password>@<cluster>.mongodb.net/
+
+# ----------------------------------------------------------
+# Vector search provider (optional)
+# Choose one: "atlas" or "openai"
+# Leave unset to use keyword tag matching only (no embeddings)
+# ----------------------------------------------------------
+
+# Option A — Atlas autoEmbed (Voyage-4, no API key needed)
+# Create index: history_autoembed_index (type: autoEmbed, path: dialogue)
+MEMORY_MAP_EMBED_PROVIDER=atlas
+
+# Option B — OpenAI embeddings (text-embedding-3-small)
+# Create index: history_vector_index (type: vector, path: embedding, dims: 1536)
+MEMORY_MAP_EMBED_PROVIDER=openai
+OPENAI_API_KEY=sk-...
+
+# ----------------------------------------------------------
+# Optional settings
+# ----------------------------------------------------------
+
+# GitHub token for private repos and higher API rate limits
+# GITHUB_TOKEN=ghp_...
+
+# Max size per memory entry in KB (default: 10)
+# MCP_MAX_ENTRY_KB=10
+
+# Timeout in seconds for git commands (default: 10)
+# MCP_GIT_TIMEOUT=10
+
+# Restrict all path arguments to a root directory
+# MCP_WORKSPACE_ROOT=/path/to/workspace

memory_map_mcp-0.1.0/.github/workflows/benchmark.yml

@@ -0,0 +1,60 @@
+name: Retrieval Benchmark
+
+on:
+  workflow_dispatch:
+    inputs:
+      k:
+        description: Recall/Precision/nDCG cutoff
+        default: "5"
+        required: false
+      index_wait:
+        description: Seconds to wait for Atlas vector index sync (set >0 only with Atlas URI)
+        default: "0"
+        required: false
+
+jobs:
+  benchmark:
+    name: Retrieval benchmark
+    runs-on: ubuntu-latest
+
+    services:
+      mongodb:
+        image: mongo:7
+        ports:
+          - 27017:27017
+        options: >-
+          --health-cmd "mongosh --eval 'db.runCommand({ ping: 1 })'"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    env:
+      MEMORY_MAP_MONGO_URI: ${{ secrets.MEMORY_MAP_MONGO_URI || 'mongodb://localhost:27017' }}
+      MEMORY_MAP_EMBED_PROVIDER: ${{ secrets.MEMORY_MAP_EMBED_PROVIDER || '' }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY || '' }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Run benchmark
+        run: |
+          python benchmarks/bench_retrieval.py \
+            --k ${{ inputs.k || 5 }} \
+            --index-wait ${{ inputs.index_wait || 0 }} \
+            --verbose
+
+      - name: Upload results
+        uses: actions/upload-artifact@v4
+        with:
+          name: benchmark-results
+          path: benchmarks/results/
+          retention-days: 90

memory_map_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    services:
+      mongodb:
+        image: mongo:7
+        ports:
+          - 27017:27017
+        options: >-
+          --health-cmd "mongosh --eval 'db.runCommand({ ping: 1 })'"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    env:
+      MEMORY_MAP_MONGO_URI: mongodb://localhost:27017
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v --tb=short

memory_map_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build wheel and sdist
+        run: |
+          pip install build
+          python -m build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/memory-map-mcp
+    permissions:
+      id-token: write  # required for OIDC trusted publishing
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

memory_map_mcp-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+venv/
+.venv/
+__pycache__/
+.pytest_cache/
+*.pyc
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+
+.mcp_memory.json
+.mcp_memory.json.lock
+*.bak.*
+.mcp_history.json
+.env
+.vscode/
+.claude/
+CLAUDE.md
+
+# Benchmark result artifacts — force-add with `git add -f` to commit a baseline
+benchmarks/results/*.json
+
+# Manual dev scripts (hardcoded local paths, superseded by pytest suite)
+tests/test_client.py
+tests/quick_git_test.py
+tests/test_setup.py
+test_question.py
+test_setup.py

memory_map_mcp-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,25 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to making participation in this project a respectful and harassment-free experience for everyone, regardless of background or identity.
+
+## Our Standards
+
+**Expected behaviour:**
+- Use welcoming and inclusive language
+- Be respectful of differing viewpoints and experience
+- Accept constructive feedback gracefully
+- Focus on what is best for the community
+
+**Unacceptable behaviour:**
+- Harassment, insults, or derogatory comments
+- Personal or political attacks
+- Publishing others' private information without consent
+- Any conduct that would be inappropriate in a professional setting
+
+## Enforcement
+
+Instances of unacceptable behaviour may be reported by opening a GitHub issue or contacting the maintainer directly. All reports will be reviewed and investigated promptly and fairly.
+
+This project follows the [Contributor Covenant](https://www.contributor-covenant.org/) principles (v2.1).

memory_map_mcp-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Contributing to Memory Map
+
+Thanks for your interest in contributing!
+
+## Getting started
+
+1. Fork the repo and clone your fork
+2. Create a virtual environment and install dependencies:
+
+```bash
+python -m venv venv
+venv\Scripts\activate       # Windows
+source venv/bin/activate    # Mac/Linux
+pip install -r requirements.txt
+```
+
+3. Create a branch for your change:
+
+```bash
+git checkout -b your-feature-name
+```
+
+## Making changes
+
+- All server logic lives in `server.py`
+- Tests are in the `tests/` directory — run them with `pytest`
+- Keep changes focused; one fix or feature per PR
+
+## Submitting a pull request
+
+1. Push your branch and open a PR against `main`
+2. Describe what the change does and why
+3. If it fixes a bug, include steps to reproduce the original issue
+
+## Reporting issues
+
+Open a GitHub issue with:
+- What you expected to happen
+- What actually happened
+- Your OS, Python version, and Claude Code version

memory_map_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sidhartha Mohanty 
+
+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.