Code Context MCP

🚀 Code Context MCP Server

A Model Context Protocol (MCP) server that provides code context from a local Git repository. This server enables you to:

• Clone Git repositories locally.
• Handle branches and files.
• Generate embeddings for code snippets.
• Perform semantic searches on the code.

✨ Features

• Utilize a local Git repository instead of the GitHub API.
• Store data in an SQLite database.
• Split code into semantic blocks.
• Generate code snippet embeddings using Ollama.
• Provide semantic search for code.

📦 Installation

Prerequisites

• Node.js (v16+)
• Git
• Ollama with an embedding model

# Clone the repository
git clone <repository-url>
cd code-context-mcp

# Install dependencies
npm install

# Build the project
npm run build

📚 Documentation

Configuration

Set the following environment variables:

• DATA_DIR: Directory for the SQLite database (Default: ~/.codeContextMcp/data).
• REPO_CACHE_DIR: Directory for cloned repositories (Default: ~/.codeContextMcp/repos).

Using Ollama

For faster and more powerful embeddings, you can use Ollama:

# Install Ollama from https://ollama.ai/

# Pull an embedding model (unclemusclez/jina-embeddings-v2-base-code recommended)
ollama pull unclemusclez/jina-embeddings-v2-base-code

💻 Usage Examples

Using with Claude Desktop

Add the following configuration to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "code-context-mcp": {
      "command": "/path/to/your/node",
      "args": ["/path/to/code-context-mcp/dist/index.js"]
    }
  }
}

Tools

The server provides the following tools:

queryRepo

Clone a repository, process the code, and perform a semantic search:

{
  "repoUrl": "https://github.com/username/repo.git",
  "branch": "main", // Optional - Defaults to the repository's default branch
  "query": "Your search query",
  "keywords": ["keyword1", "keyword2"], // Optional - Filter results by keywords
  "filePatterns": ["**/*.ts", "src/*.js"], // Optional - Filter files using glob patterns
  "excludePatterns": ["**/node_modules/**"], // Optional - Exclude files using glob patterns
  "limit": 10 // Optional - Number of results, defaults to 10
}

Debugging

For ARM architecture issues on Mac M-series chips:

# Try the following commands:
curl http://localhost:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'
curl http://127.0.0.1:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'
curl http://[::1]:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'

📄 License

MIT