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。