{"id":49182255,"url":"https://github.com/apajon/mempalace-mcp-bridge","last_synced_at":"2026-04-23T02:01:09.240Z","repository":{"id":350225472,"uuid":"1205289466","full_name":"apajon/mempalace-mcp-bridge","owner":"apajon","description":"Plug-and-play MemPalace MCP bridge for VS Code Copilot Chat with persistent memory.","archived":false,"fork":false,"pushed_at":"2026-04-17T16:21:50.000Z","size":262,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T16:32:55.373Z","etag":null,"topics":["ai-memory","copilot","copilot-coding-agent","developer-tools","mcp","mempalace","vscode"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apajon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-08T20:28:31.000Z","updated_at":"2026-04-17T16:15:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/apajon/mempalace-mcp-bridge","commit_stats":null,"previous_names":["apajon/mempalace-vscode-chat","apajon/mempalace-mcp-bridge"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/apajon/mempalace-mcp-bridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apajon%2Fmempalace-mcp-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apajon%2Fmempalace-mcp-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apajon%2Fmempalace-mcp-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apajon%2Fmempalace-mcp-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apajon","download_url":"https://codeload.github.com/apajon/mempalace-mcp-bridge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apajon%2Fmempalace-mcp-bridge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32162611,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"online","status_checked_at":"2026-04-23T02:00:06.710Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-memory","copilot","copilot-coding-agent","developer-tools","mcp","mempalace","vscode"],"created_at":"2026-04-23T02:01:08.190Z","updated_at":"2026-04-23T02:01:09.203Z","avatar_url":"https://github.com/apajon.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MemPalace MCP Bridge for VS Code Copilot\n\nGive [MemPalace](https://github.com/milla-jovovich/mempalace) a persistent local memory inside VS Code Copilot Chat.\n\nThis repo provides a plug-and-play bridge:\n\n- one-command setup\n- generated workspace MCP config\n- automatic MCP server startup through VS Code\n- full-stack verification with `verify.sh`\n- a stable ChromaDB `0.6.x` line for existing palaces\n\n---\n\n## What you get\n\n- Persistent memory inside Copilot Chat\n- Fully local — no cloud, no API key, no Docker\n- Auto-start — no terminal, VS Code handles everything\n- Mine your own files — query your notes, docs, and decisions\n- Built-in verification — `verify.sh` classifies the bridge as healthy, suspicious, or unsafe by checking the environment, the generated MCP config, real MCP startup, and palace manifest drift\n- Palace safety checks — setup, update, verify, and runtime startup reject unsupported `chromadb` versions and keep the bridge on the supported `0.6.x` line\n- Palace format safety gate — risky stable-path operations refuse palaces detected as `chroma_1_x` or `unknown`\n- Palace manifest — setup writes `mempalace-bridge-manifest.json` into the palace root for version traceability\n- Reusable across environments with a shared palace\n\n\u003e **Compatibility status**\n\u003e This bridge targets ChromaDB `0.6.x` only (`chromadb\u003e=0.6,\u003c0.7`).\n\u003e ChromaDB `1.x` uses an incompatible storage format; non-`0.6.x` installs are rejected at startup.\n\u003e Palaces detected as `chroma_1_x` or `unknown` format are also rejected before any operation.\n\u003e `main` fails fast when the installed `chromadb` version is outside the `0.6.x` range.\n\n---\n\n## Install\n\nDownload the latest release: https://github.com/apajon/mempalace-mcp-bridge/releases\n\n---\n\n## Who this is for\n\nThis repo is for you if:\n\n- you want MemPalace working fast inside VS Code Copilot Chat\n- you want a local setup with no manual MCP wiring\n- you want a stable setup for existing palaces on Chroma `0.6.x`\n- you prefer reproducibility over chasing the newest Chroma release\n\n---\n\n## Quickstart\n\n```bash\n# 1. Clone\ngit clone https://github.com/apajon/mempalace-mcp-bridge.git\ncd mempalace-mcp-bridge\n\n# 2. Setup everything (installs uv, MemPalace, mines sample data, writes .mcp.json)\nbash setup.sh\n\n# 3. Open this folder in VS Code\n\ncode .\n```\n\n\u003e **Important:** open the repository root folder in VS Code (`code .` from inside `mempalace-mcp-bridge/`). Opening a subfolder will prevent MCP from loading.\n\nOptionally verify the generated setup before opening Copilot Chat:\n\n```bash\nbash verify.sh\n```\n\n`verify.sh` is intentionally narrow. It checks the pinned Python/Chroma environment, the installed MemPalace version, `.mcp.json` integrity, real MCP startup, palace readability, and whether the palace manifest still matches the active environment. The summary is one of:\n\n- **SUPPORTED and healthy** — all checks passed\n- **SUPPORTED but suspicious** — the bridge still works, but drift was detected and should be reviewed\n- **UNSUPPORTED or unsafe** — do not rely on the bridge until the failures are fixed\n\n---\n\n## Test it in Copilot\n\n```bash\n# Open Copilot Chat and try:\n\n\"Remember that I like Python.\"\n\nRestart VS Code, then ask:\n\n\"What do you remember about me?\"\n```\n\nVS Code auto-starts the MemPalace MCP server when Copilot Chat opens.\n\n\n\nSetup is complete. Advanced usage is optional.\n\n---\n\n## Use your own data\n\nTo mine your own notes after setup:\n\n```bash\nuv run --directory . mempalace mine /path/to/your/project\n```\n\nThen ask Copilot about anything in those files.\n\n---\n\n## Known limitations\n\n- This bridge currently targets ChromaDB `0.6.x`, not ChromaDB `1.x`\n- `main` hard-fails outside the supported `chromadb\u003e=0.6,\u003c0.7` range\n- No migration to ChromaDB `1.x` is provided. Non-`0.6.x` palaces are blocked at startup.\n- Experimental ChromaDB `1.x` investigation work exists outside this project's stable contract and is not part of the supported bridge workflow.\n- Linux / WSL2 is the tested path today\n- Copilot behavior remains probabilistic even with MemPalace as the preferred context source\n\n---\n\n## Why this exists\n\nMemPalace is powerful, but not plug-and-play in real workflows.\n\nSetting it up requires multiple manual steps and breaks the flow of using Copilot Chat.\n\nThat friction stops most users before they get any value.\n\nThis repo removes that friction. Setup takes about 2 minutes.\n\n---\n\n## How it fits together\n\n```\nVsCode Copilot Chat\n     │\n     ▼\nMCP Server  ← launched automatically by Copilot via .mcp.json\n     │\n     ▼\nMemPalace\n     │\n     ▼\nLocal Memory (palace)  ← ~/.mempalace/palace\n```\n\n`setup.sh` generates `.mcp.json` with the absolute path to your `uv` binary, so Copilot can start the server without any manual configuration.\n\nIf you already have a legacy `.vscode/mcp.json`, migrate it with:\n\n```bash\njq '{mcpServers: .servers}' .vscode/mcp.json \u003e .mcp.json\n```\n\nThe same setup step writes `mempalace-bridge-manifest.json` into the palace root. The file is intentionally small and easy to inspect manually: it records the bridge version, MemPalace version, ChromaDB version, Python version, storage backend and format, the supported compatibility line, and the creation timestamp. If a valid manifest already exists, setup preserves it. If the file exists but is malformed, setup replaces it with a fresh valid manifest.\n\n---\n\n## Beyond setup — structured memory (optional)\n\nThe setup alone is already useful. But MemPalace works significantly better when memory is structured.\n\nThis repo includes patterns for:\n\n- **Separating project vs. shared knowledge** — avoid polluting general knowledge with project-specific rules\n- **Avoiding duplication and drift** — mine once, query from any environment\n- **Consistent context across sessions** — decisions persist and remain retrievable\n\n→ See [docs/advanced_memory_strategy.md](docs/advanced_memory_strategy.md) for the full approach.\n\n---\n\n## Compatibility\n\n- Linux (tested on Ubuntu 24.04 via WSL2)\n- VS Code with [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)\n- `curl` required (`setup.sh` uses it to install `uv`)\n- ChromaDB `0.6.x` line pinned intentionally via `chromadb\u003e=0.6,\u003c0.7`\n\n`setup.sh` installs `uv` and Python 3.12 automatically.\n\n---\n\n## Copilot context guidance\n\nCopilot is configured to use MemPalace as its primary context source via `.github/copilot-instructions.md`.\n\nQuery order: MemPalace project wing → shared wings → `docs/architecture.md` → `README.md` → workspace search.\n\nThis improves first-response relevance. It is not a strict guarantee — Copilot behavior is probabilistic.\n\n---\n\n## Docs\n\nIf you want to go deeper:\n\n| Topic | Link |\n|-------|------|\n| Architecture overview | [docs/architecture.md](docs/architecture.md) |\n| MCP config and VS Code integration | [docs/mcp_vscode.md](docs/mcp_vscode.md) |\n| Palace format detection | [docs/palace_format_detection.md](docs/palace_format_detection.md) |\n| Devcontainer integration | [docs/devcontainer_integration.md](docs/devcontainer_integration.md) |\n| Update and verify workflow | [docs/update_workflow.md](docs/update_workflow.md) |\n| Troubleshooting | [docs/troubleshooting.md](docs/troubleshooting.md) |\n| Structured memory example | [docs/memory_example.md](docs/memory_example.md) |\n| Advanced memory strategy | [docs/advanced_memory_strategy.md](docs/advanced_memory_strategy.md) |\n| MemPalace project | [github.com/milla-jovovich/mempalace](https://github.com/milla-jovovich/mempalace) |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapajon%2Fmempalace-mcp-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapajon%2Fmempalace-mcp-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapajon%2Fmempalace-mcp-bridge/lists"}