# 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.
---
## 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* 🚀
Raw data
{
"_id": null,
"home_page": "https://github.com/MrUnreal/codemind",
"name": "mcp-codemind",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mcp, model-context-protocol, github-copilot, code-analysis, semantic-search",
"author": "MrUnreal",
"author_email": "MrUnreal <mrunreal@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/1a/a6/d3a0475ed76736d235353de1a1929f5b6460d08e12a3622d8e77bd5c6411/mcp_codemind-2.0.1.tar.gz",
"platform": null,
"description": "\ufeff# CodeMind \ud83e\udde0\r\n\r\n> Give GitHub Copilot memory across all your projects\r\n\r\n[]() []() []()\r\n\r\n**CodeMind** is an MCP server that gives GitHub Copilot 20 specialized tools for understanding your codebase.\r\n\r\n---\r\n\r\n## Why CodeMind?\r\n\r\n**Without it:**\r\n- \u274c Copilot creates duplicate files\r\n- \u274c Forgets decisions you just made\r\n- \u274c Doesn't understand your project structure\r\n\r\n**With it:**\r\n- \u2705 Finds existing code before creating new files\r\n- \u2705 Remembers architectural decisions\r\n- \u2705 Understands dependencies and relationships\r\n- \u2705 Warns about breaking changes\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\n**1. Install**\r\n```bash\r\ngit clone https://github.com/MrUnreal/codemind.git\r\ncd codemind\r\npip install -r requirements.txt\r\n```\r\n\r\n**2. Configure VS Code**\r\n\r\nAdd to `.vscode/settings.json`:\r\n```json\r\n{\r\n \"mcp.servers\": {\r\n \"codemind\": {\r\n \"command\": \"python\",\r\n \"args\": [\"D:/Projects/Python/CodeMind/codemind.py\"]\r\n }\r\n }\r\n}\r\n```\r\n\r\n**3. Reload**\r\n\r\nPress `Ctrl+Shift+P` \u2192 \"Developer: Reload Window\"\r\n\r\nDone! \ud83c\udf89\r\n\r\n---\r\n\r\n## What You Get\r\n\r\n**20 AI Tools in 6 Categories:**\r\n\r\n| Category | What It Does |\r\n|----------|-------------|\r\n| \ud83d\udd0d Search | Find existing code, check if features exist |\r\n| \ud83d\udcdd Context | Understand files, track changes, remember decisions |\r\n| \ud83d\udd17 Dependencies | See what imports what, visualize structure |\r\n| \ud83d\udcca Analysis | Code quality metrics, config auditing |\r\n| \u26a0\ufe0f Safety | Check breaking changes before refactoring |\r\n| \ud83d\uddc2\ufe0f Management | Index files, find TODOs, git history |\r\n\r\n---\r\n\r\n## How It Works\r\n\r\n**You ask naturally:**\r\n```\r\n\"Add authentication\"\r\n```\r\n\r\n**Copilot automatically:**\r\n1. Searches existing code\r\n2. Finds `src/auth/jwt.py`\r\n3. Suggests modifying it instead of creating new files\r\n\r\n**No explicit tool calls needed!**\r\n\r\n---\r\n\r\n## Example Usage\r\n\r\n```\r\n\ud83d\udcac \"Does this project have authentication?\"\r\n\u2705 Found in src/auth/jwt.py\r\n\r\n\ud83d\udcac \"What will break if I rename UserModel?\"\r\n\u26a0\ufe0f 7 files will be affected\r\n\r\n\ud83d\udcac \"What depends on database.py?\"\r\n\ud83d\udccb Used by: models/, auth/, tests/\r\n\r\n\ud83d\udcac \"Show me TODOs\"\r\n\ud83d\udcdd Found 12 TODOs across 5 files\r\n```\r\n\r\n---\r\n\r\n## Multi-Workspace Support\r\n\r\nWork with multiple projects simultaneously:\r\n- Each project gets its own database\r\n- No cross-contamination\r\n- Isolated configurations\r\n\r\n---\r\n\r\n## Documentation\r\n\r\n| Document | Purpose |\r\n|----------|---------|\r\n| [Usage Guide](USAGE_GUIDE.md) | How to use with Copilot |\r\n| [Changelog](CHANGELOG.md) | Version history |\r\n| [Tools Reference](docs/TOOLS.md) | All 20 tools explained |\r\n| [Architecture](docs/ARCHITECTURE.md) | Technical details |\r\n| [Examples](docs/EXAMPLES.md) | Real-world scenarios |\r\n| [FAQ](docs/FAQ.md) | Common questions |\r\n\r\n---\r\n\r\n## Requirements\r\n\r\n- Python 3.10+\r\n- VS Code with GitHub Copilot\r\n- ~80MB for embedding model\r\n- ~5MB per project for database\r\n\r\n---\r\n\r\n## Status\r\n\r\n- \u2705 20/20 tools operational\r\n- \u2705 110+ tests passing (99%+ rate)\r\n- \u2705 Production ready\r\n- \u2705 Actively maintained\r\n\r\n---\r\n\r\n## Contributing\r\n\r\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md)\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT - See [LICENSE](LICENSE)\r\n\r\n---\r\n\r\n**Built with**: Python, FastMCP, sentence-transformers, SQLite\r\n\r\n*Making Copilot smarter, one project at a time* \ud83d\ude80\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Multi-Workspace MCP Memory Server for GitHub Copilot with automatic re-indexing",
"version": "2.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/MrUnreal/codemind/issues",
"Changelog": "https://github.com/MrUnreal/codemind/blob/master/CHANGELOG.md",
"Documentation": "https://github.com/MrUnreal/codemind/blob/master/README.md",
"Homepage": "https://github.com/MrUnreal/codemind",
"Repository": "https://github.com/MrUnreal/codemind"
},
"split_keywords": [
"mcp",
" model-context-protocol",
" github-copilot",
" code-analysis",
" semantic-search"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fdcc6f14564b370479c45ce62006042b17295337eec551575da8e20ad7401343",
"md5": "f778771ceffc2d07871432c84150ebc7",
"sha256": "d5563db3004685d48159e061b7eeee8bebcf2470540b92a69cf3d9f7d746e9d4"
},
"downloads": -1,
"filename": "mcp_codemind-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f778771ceffc2d07871432c84150ebc7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 37216,
"upload_time": "2025-10-18T01:26:20",
"upload_time_iso_8601": "2025-10-18T01:26:20.359946Z",
"url": "https://files.pythonhosted.org/packages/fd/cc/6f14564b370479c45ce62006042b17295337eec551575da8e20ad7401343/mcp_codemind-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1aa6d3a0475ed76736d235353de1a1929f5b6460d08e12a3622d8e77bd5c6411",
"md5": "95ac691cdc647de57b5096277153b6bf",
"sha256": "1a5b0db86da1139d9b28f6d0479c71d7f98d5bb4964fe17d234b04a684682da8"
},
"downloads": -1,
"filename": "mcp_codemind-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "95ac691cdc647de57b5096277153b6bf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 46696,
"upload_time": "2025-10-18T01:26:21",
"upload_time_iso_8601": "2025-10-18T01:26:21.644226Z",
"url": "https://files.pythonhosted.org/packages/1a/a6/d3a0475ed76736d235353de1a1929f5b6460d08e12a3622d8e77bd5c6411/mcp_codemind-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-18 01:26:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MrUnreal",
"github_project": "codemind",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "fastmcp",
"specs": [
[
">=",
"0.2.0"
]
]
},
{
"name": "sentence-transformers",
"specs": [
[
">=",
"2.2.0"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.24.0"
]
]
},
{
"name": "radon",
"specs": [
[
">=",
"6.0.0"
]
]
}
],
"lcname": "mcp-codemind"
}
JSON
