CodeMind 🧠

Give GitHub Copilot memory across all your projects

CodeMind is an MCP server that gives GitHub Copilot 20 specialized tools for understanding your codebase.

<!-- mcp-name: io.github.MrUnreal/codemind -->

---

Why CodeMind?

Without it:

• ❌ Copilot creates duplicate files
• ❌ Forgets decisions you just made
• ❌ Doesn't understand your project structure

With it:

• ✅ Finds existing code before creating new files
• ✅ Remembers architectural decisions
• ✅ Understands dependencies and relationships
• ✅ Warns about breaking changes

---

Quick Start

Option 1: Install from PyPI (Recommended)

1. Install the package

pip install mcp-codemind

2. Configure VS Code

Add to .vscode/settings.json:

{
  "mcp.servers": {
    "codemind": {
      "command": "python",
      "args": ["-m", "codemind"]
    }
  }
}

3. Reload

Press Ctrl+Shift+P → "Developer: Reload Window"

Done! 🎉

---

Option 2: Install from Source

1. Clone and install

git clone https://github.com/MrUnreal/codemind.git
cd codemind
pip install -r requirements.txt

2. Configure VS Code

Add to your VS Code settings (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)"):

{
  "mcp.servers": {
    "codemind": {
      "command": "python",
      "args": ["/full/path/to/codemind.py"],
      "cwd": "${workspaceFolder}"
    }
  }
}

Replace /full/path/to/codemind.py with the actual path to where you cloned CodeMind.

3. Reload VS Code

Press Ctrl+Shift+P → "Developer: Reload Window"

4. Test It

Open Copilot Chat and try:

Does this project have authentication?

Done! 🎉

Need help? Check our Troubleshooting Guide

---

What You Get

20 AI Tools in 6 Categories:

Category	What It Does
🔍 Search	Find existing code, check if features exist
📝 Context	Understand files, track changes, remember decisions
🔗 Dependencies	See what imports what, visualize structure
📊 Analysis	Code quality metrics, config auditing
⚠️ Safety	Check breaking changes before refactoring
🗂️ Management	Index files, find TODOs, git history

---

How It Works

┌─────────────────────────────────────────────────────────────┐
│  You: "Add authentication"                                  │
└────────────────────────┬────────────────────────────────────┘
                         │
                         v
┌─────────────────────────────────────────────────────────────┐
│  Copilot (with CodeMind):                                   │
│  🔍 Searching existing code...                              │
│  âś… Found: src/auth/jwt.py (95% match)                      │
│  💡 "I found existing JWT auth. Should I extend it?"        │
└─────────────────────────────────────────────────────────────┘

Without CodeMind:
❌ Creates duplicate auth files
❌ Doesn't know about existing code
❌ No context of your architecture

You ask naturally → Copilot automatically uses CodeMind → Gets smart suggestions

No explicit tool calls needed!

---

Example Usage

💬 "Does this project have authentication?"
✅ Found in src/auth/jwt.py

💬 "What will break if I rename UserModel?"
⚠️ 7 files will be affected

💬 "What depends on database.py?"
📋 Used by: models/, auth/, tests/

💬 "Show me TODOs"
📝 Found 12 TODOs across 5 files

---

Multi-Workspace Support

Work with multiple projects simultaneously:

• Each project gets its own database
• No cross-contamination
• Isolated configurations

---

Documentation

Document	Purpose
Getting Started	Start here! Complete beginner's guide
Usage Guide	How to use with Copilot
Contributing	How to contribute to CodeMind
Tools Reference	All 20 tools explained
Examples	Real-world scenarios
FAQ	Common questions
Architecture	Technical details
Changelog	Version history

---

Requirements

• Python 3.8 or higher
• VS Code with GitHub Copilot
• ~80MB for embedding model (downloaded automatically on first use)
• ~1-5MB per project for database

---

Status

• ✅ 20/20 tools operational
• ✅ 110+ tests passing (99%+ rate)
• ✅ Production ready
• ✅ Actively maintained

---

Contributing

Contributions welcome! See CONTRIBUTING.md

---

License

MIT - See LICENSE

---

Built with: Python, FastMCP, sentence-transformers, SQLite

Making Copilot smarter, one project at a time 🚀