Kontxt MCP Server

@ReyNeill

Basic information

About Kontxt MCP Server

Codebase indexing MCP server

Kontxt MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Kontxt": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Kontxt MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Kontxt MCP Server?

Kontxt MCP Server is a Model Context Protocol server that indexes a user-specified local code repository and provides the get_codebase_context tool for AI clients like Cursor or Claude Desktop. It uses Google Gemini (default: gemini-2.5-flash-preview-04-17) internally to analyze the codebase and generate contextual responses based on the user’s query.

How to use Kontxt MCP Server?

Clone the repository, create a Python virtual environment, install dependencies from requirements.txt, and ensure the tree command is available on your system. Configure a Gemini API key in a .env file or via the --gemini-api-key argument. Run the server with python kontxt_server.py --repo-path /path/to/your/codebase. It starts in SSE mode on http://127.0.0.1:8080/sse by default; clients connect to this endpoint.

Key features of Kontxt MCP Server

Connects to a local code repository for analysis.
Provides the get_codebase_context tool for AI clients.
Uses Gemini 2.0 Flash (or custom model) with 1M input window.
Supports SSE (recommended) and stdio transport protocols.
Tracks token usage and allows configurable token limits (500k, 800k, 1M).
Accepts user-attached files and additional context from queries.

Use cases of Kontxt MCP Server

Ask an AI client “What’s this codebase about?” using the MCP tool.
“How does the authentication system work?” – context-aware explanation.
“Explain the data flow in the application” – targeted analysis.
Compare implementations across files by referencing them in queries.

Frequently asked questions

What transport protocols does Kontxt MCP Server support?

It supports SSE (Server‑Sent Events, recommended) and stdio transport. Use `--transport sse` or `--transport stdio`.

What are the runtime requirements?

Python 3, the `tree` command, and a Google Gemini API key. The server uses the `google/gemma-7b` tokenizer for token estimation (gated on Hugging Face; free access requires accepting terms).

How do I configure CORS?

By default only loopback origins are allowed. Use `--cors-origins` with a comma‑separated list of origins, or set the `KONTXT_CORS_ORIGINS` environment variable. Credentials are off unless `--cors-credentials` is set.

How do I stop the server?

Press `Ctrl+C` in the terminal. The server attempts a graceful shutdown with a 3‑second timeout.

Can I change the Gemini model or token limit?

Yes. Use `--gemini-model NAME` to specify a different model (default: `models/gemini-2.5-flash-preview-04-17`) and `--token-threshold NUM` to set the token limit to 500000, 800000 (default), or 1000000.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3