Metadata-Version: 2.4
Name: mcp-codemind
Version: 2.0.1
Summary: Multi-Workspace MCP Memory Server for GitHub Copilot with automatic re-indexing
Home-page: https://github.com/MrUnreal/codemind
Author: MrUnreal
Author-email: MrUnreal <mrunreal@users.noreply.github.com>
License: MIT
Project-URL: Homepage, https://github.com/MrUnreal/codemind
Project-URL: Documentation, https://github.com/MrUnreal/codemind/blob/master/README.md
Project-URL: Repository, https://github.com/MrUnreal/codemind
Project-URL: Bug Tracker, https://github.com/MrUnreal/codemind/issues
Project-URL: Changelog, https://github.com/MrUnreal/codemind/blob/master/CHANGELOG.md
Keywords: mcp,model-context-protocol,github-copilot,code-analysis,semantic-search
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Text Processing :: Indexing
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp<1.0.0,>=0.2.0
Requires-Dist: sentence-transformers<3.0.0,>=2.2.0
Requires-Dist: numpy<2.0.0,>=1.24.0
Requires-Dist: radon<7.0.0,>=6.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

﻿# CodeMind 🧠

> Give GitHub Copilot memory across all your projects

[![Tests](https://img.shields.io/badge/tests-110%2B%20passing-brightgreen)]() [![Python](https://img.shields.io/badge/python-3.10%2B-blue)]() [![License](https://img.shields.io/badge/license-MIT-blue)]()

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

---

## 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

**1. Install**
```bash
git clone https://github.com/MrUnreal/codemind.git
cd codemind
pip install -r requirements.txt
```

**2. Configure VS Code**

Add to `.vscode/settings.json`:
```json
{
  "mcp.servers": {
    "codemind": {
      "command": "python",
      "args": ["D:/Projects/Python/CodeMind/codemind.py"]
    }
  }
}
```

**3. Reload**

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

Done! 🎉

---

## 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 ask naturally:**
```
"Add authentication"
```

**Copilot automatically:**
1. Searches existing code
2. Finds `src/auth/jwt.py`
3. Suggests modifying it instead of creating new files

**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 |
|----------|---------|
| [Usage Guide](USAGE_GUIDE.md) | How to use with Copilot |
| [Changelog](CHANGELOG.md) | Version history |
| [Tools Reference](docs/TOOLS.md) | All 20 tools explained |
| [Architecture](docs/ARCHITECTURE.md) | Technical details |
| [Examples](docs/EXAMPLES.md) | Real-world scenarios |
| [FAQ](docs/FAQ.md) | Common questions |

---

## Requirements

- Python 3.10+
- VS Code with GitHub Copilot
- ~80MB for embedding model
- ~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](CONTRIBUTING.md)

---

## License

MIT - See [LICENSE](LICENSE)

---

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

*Making Copilot smarter, one project at a time* 🚀
