Smart Code Search MCP Server

# Credits and Attribution ## Core Dependencies This project builds upon the excellent work of many open-source projects and their contributors: ### Model Context Protocol (MCP) - **Project**: [MCP](https://modelcontextprotocol.io/) - **License**: MIT - **Copyright**: © 2024 Anthropic - **Usage**: Core protocol for Claude Desktop integration ### Sentence Transformers - **Project**: [sentence-transformers](https://www.sbert.net/) - **License**: Apache 2.0 - **Authors**: Nils Reimers and Iryna Gurevych - **Paper**: "Sentence-BERT: Sentence Embeddings using Siamese BERT-Networks" (2019) - **Usage**: Semantic embeddings for code search ### Tree-sitter - **Project**: [tree-sitter](https://tree-sitter.github.io/tree-sitter/) - **License**: MIT - **Copyright**: © 2018 Max Brunsfeld - **Usage**: Code parsing and AST analysis for multiple languages ### PyTorch - **Project**: [PyTorch](https://pytorch.org/) - **License**: BSD-3-Clause - **Copyright**: © Facebook, Inc. and its affiliates - **Usage**: Deep learning framework for embeddings ### Hugging Face Transformers - **Project**: [transformers](https://huggingface.co/transformers/) - **License**: Apache 2.0 - **Copyright**: © 2018-2024 The Hugging Face team - **Usage**: Pre-trained transformer models ### ChromaDB - **Project**: [ChromaDB](https://www.trychroma.com/) - **License**: Apache 2.0 - **Copyright**: © 2023 Chroma Inc. - **Usage**: Vector database for embeddings (optional backend) ### NumPy - **Project**: [NumPy](https://numpy.org/) - **License**: BSD-3-Clause - **Copyright**: © 2005-2024 NumPy Developers - **Usage**: Numerical computations for embeddings ### scikit-learn - **Project**: [scikit-learn](https://scikit-learn.org/) - **License**: BSD-3-Clause - **Copyright**: © 2007-2024 The scikit-learn developers - **Usage**: Cosine similarity and clustering algorithms ### GitPython - **Project**: [GitPython](https://github.com/gitpython-developers/GitPython) - **License**: BSD-3-Clause - **Copyright**: © 2008-2024 Michael Trier and contributors - **Usage**: Git repository analysis and history search ### Pydantic - **Project**: [Pydantic](https://pydantic-docs.helpmanual.io/) - **License**: MIT - **Copyright**: © 2017-2024 Samuel Colvin and contributors - **Usage**: Data validation and settings management ## Language Parsers Tree-sitter language parsers used in this project: - **tree-sitter-python**: MIT License - **tree-sitter-javascript**: MIT License - **tree-sitter-typescript**: MIT License - **tree-sitter-java**: MIT License - **tree-sitter-cpp**: MIT License - **tree-sitter-go**: MIT License - **tree-sitter-rust**: MIT License - **tree-sitter-ruby**: MIT License ## Pre-trained Models ### all-MiniLM-L6-v2 - **Source**: [Hugging Face](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2) - **License**: Apache 2.0 - **Authors**: Microsoft Research - **Based on**: MiniLM architecture - **Usage**: Default embedding model for semantic search ## Development Tools ### Testing and Quality - **pytest**: MIT License - Testing framework - **black**: MIT License - Code formatter - **flake8**: MIT License - Linting - **mypy**: MIT License - Type checking - **pre-commit**: MIT License - Git hooks ### Documentation - **mkdocs**: BSD License - Documentation generation - **mkdocs-material**: MIT License - Documentation theme ## Inspiration and References This project was inspired by and learned from: 1. **Semantic Code Search Papers**: - "CodeSearchNet Challenge" (2019) - GitHub & Microsoft Research - "Neural Code Search Evaluation Dataset" (2018) - Facebook Research - "Deep Code Search" (2018) - Gu et al. 2. **Similar Projects**: - [CodeQL](https://codeql.github.com/) - Semantic code analysis - [Sourcegraph](https://sourcegraph.com/) - Code search and intelligence - [OpenGrok](https://oracle.github.io/opengrok/) - Source code search engine 3. **MCP Server Examples**: - Official MCP server examples from Anthropic - Community MCP implementations ## Special Thanks - **Anthropic Team**: For creating the MCP protocol and Claude Desktop - **Open Source Community**: For maintaining the libraries this project depends on - **Contributors**: Everyone who has contributed code, bug reports, or suggestions ## License Compliance All dependencies are used in compliance with their respective licenses. The complete license texts for each dependency can be found in their respective repositories. This project is licensed under the MIT License, which is compatible with all the dependencies listed above. ## Contributing If you notice any missing attributions or incorrect information, please open an issue or submit a pull request to help us maintain proper attribution. --- *Last updated: January 2025*