davidvc/code-knowledge-mcptool

A knowledge management tool for code repositories using vector embeddings. This tool helps maintain and query knowledge about your codebase using advanced embedding techniques.
## Building and Installing
### 1. Build the Package
First, you need to build the distribution files:
bash
# Clone the repository
git clone https://github.com/yourusername/code-knowledge-tool.git
cd code-knowledge-tool
# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate
# Install build tools
python -m pip install --upgrade pip build
# Build the package
python -m build
This will create two files in the dist/ directory:
codeknowledgetool-0.1.0-py3-none-any.whl (wheel file for installation)
codeknowledgetool-0.1.0.tar.gz (source distribution)
### 2. Install the Package
#### Prerequisites
1. Ensure Ollama is installed and running:
bash
# Install Ollama (if not already installed)
curl https://ollama.ai/install.sh | sh
# Start Ollama service
ollama serve
2. Install the package:
##### Option 1: Install from wheel file (recommended for usage)
bash
# Navigate to where you built the package
cd /path/to/codeknowledgetool
# Install from the wheel file
pip install dist/codeknowledgetool-0.1.0-py3-none-any.whl
##### Option 2: Install in editable mode (recommended for development)
This option is best if you want to modify the tool or contribute to its development:
bash
# Assuming you're already in the code-knowledge-tool directory
# and have activated your virtual environment
# Install in editable mode with development dependencies
pip install -e ".[dev]"
## Integration with RooCode/Cline
1. Copy the MCP configuration to your settings:
For Cline (VSCode):
bash
# Open the settings file
open ~/Library/Application\ Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/clinemcpsettings.json
Add this configuration:
json
"mcpServers": {
"codeknowledge": {
"command": "python",
"args": ["-m", "codeknowledgetool.mcptool"],
"env": {
"PYTHONPATH": "${workspaceFolder}"
For RooCode:
bash
# Open the settings file
open ~/Library/Application\ Support/RooCode/roocodeconfig.json
Add the same configuration as above.
2. Restart RooCode/Cline to load the new tool.
## Using as Memory Bank and RAG Context Provider
This tool can serve as your project's memory bank and RAG context provider. To set this up:
1. Copy the provided template to your project:
bash
cp clinerulestemplate.md /path/to/your/project/.clinerules
2. Customize the rules and patterns in .clinerules for your project's needs
The template includes comprehensive instructions for:
Knowledge base management
RAG-based development workflows
Code quality guidelines
Memory management practices
See clinerulestemplate.md for the full configuration and usage details.
## Features
Local vector storage for code knowledge
Efficient embedding generation using Ollama
Support for multiple file types
Context-aware code understanding
Integration with RooCode and Cline via MCP