Kontxt

🚀 Kontxt MCP 服务器

Kontxt MCP 服务器是一个模型上下文协议 (MCP) 服务器，主要用于解决代码库索引问题（直到代理可用），为 AI 客户端提供代码库上下文支持。

🚀 快速开始

Kontxt MCP 服务器能有效解决代码库索引问题，为 AI 客户端提供代码库上下文。通过简单的安装步骤，你就能快速搭建并使用该服务器。

✨ 主要特性

• 🔗 可连接到用户指定的本地代码仓库。
• 🛠️ 提供 (get_codebase_context) 工具，供 AI 客户端（如 Cursor、Claude Desktop）使用。
• 💡 使用 Gemini 2.0 Flash 的 1M 输入窗口内部分析代码库，并根据用户的客户端查询生成上下文。
• 📋 Flash 可使用内部工具 (list_repository_structure、read_files、grep_codebase) 来了解代码。
• 📡 支持 SSE（推荐）和 stdio 传输协议。
• 📂 支持用户从客户端查询中附加的文件/文档/上下文，以便进行更针对目标的分析。
• 📊 跟踪代币使用情况并提供详细的 API 消耗分析。
• ⚙️ 用户可配置上下文生成的代币限制（选项：500k、800k 或 1M 代币，默认：800k）。

📦 安装指南

1. 克隆/下载：获取服务器代码。
2. 创建环境：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate
   

3. 安装依赖项：

   pip install -r requirements.txt
   

4. 安装 tree：确保系统中可用 tree 命令。
   • macOS: brew install tree
   • Windows: 从 Chocolatey 或其他包管理器安装。
5. 运行服务器：

   python kontxt_server.py
   

💻 使用示例

基础用法

基本查询示例

• “这个代码库是关于什么的”
• “认证系统是如何工作的？”
• “解释应用程序中的数据流”

上下文附加

在你的查询中引用文件/上下文，将被包含在分析中：

• “解释这个文件如何工作：@kontxt_server.py”
• “查找与 @user_model.py 交互的所有文件”
• “比较 @file1.js 和 @file2.js 的实现”

服务器会将这些文件提到给 Gemini，但不会自动读取或包含它们的内容。相反，Gemini 会根据查询上下文决定要读取哪些文件。

高级用法

代币使用跟踪

服务器跟踪不同操作的代币使用情况：

• 代码库结构列表
• 文件读取
• 搜索
• 用户查询中附加的文件
• 生成的响应

这些信息在操作过程中记录，帮助你监控 API 使用情况并优化你的查询。

💡 使用建议

若你想要对工具进行改进，欢迎贡献 PR。