Kontxt MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于解决代码库索引问题（直到代理可用）。

特性

• 连接到用户指定的本地代码仓库。
• 提供 (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 使用情况并优化你的查询。

PD: 想要工具改进？欢迎贡献 PR。