MCP 服务器

Kontxt MCP Server

一个模型上下文协议服务器，它将 AI 客户端连接到本地代码仓库，并使用 Gemini 2.0 Flash 分析代码库，并根据用户查询生成有针对性的上下文。

README

Kontxt MCP 服务器

一个模型上下文协议 (MCP) 服务器，旨在解决代码库索引问题（在代理能够做到之前）。

功能特性

连接到用户指定的本地代码仓库。
为 AI 客户端（如 Cursor、Claude Desktop）提供 (get_codebase_context) 工具。
内部使用 Gemini 2.0 Flash 的 1M 输入窗口来分析代码库，并根据用户的客户端查询生成上下文。
Flash 本身可以使用内部工具（list_repository_structure、read_files、grep_codebase）来理解代码。
支持 SSE（推荐）和 stdio 传输协议。
支持来自客户端查询的用户附加文件/文档/上下文，以进行更有针对性的分析。
跟踪 token 使用情况，并提供 API 消耗的详细分析。
最大化可能的上下文 token，以获得最佳的索引摘要。

设置

克隆/下载： 获取服务器代码。

创建环境：

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

安装依赖：
```
pip install -r requirements.txt
```
安装 tree： 确保您的系统上可以使用 tree 命令。
- macOS: brew install tree
- Debian/Ubuntu: sudo apt update && sudo apt install tree
- Windows: 需要安装一个端口或使用 WSL。
配置 API 密钥：
- 复制 .env.example 到 .env。
- 编辑 .env 并添加您的 Google Gemini API 密钥：
```
GEMINI_API_KEY="YOUR_ACTUAL_API_KEY"
```
- 或者，您可以通过 --gemini-api-key 命令行参数提供密钥。

作为独立服务器运行（推荐）

默认情况下，服务器以 SSE 模式运行，这允许您：

独立启动服务器
从多个客户端连接
在重启客户端时保持运行

运行服务器：

python kontxt_server.py --repo-path /path/to/your/codebase

PS: 您可以使用 pwd 来列出项目路径

服务器将默认在 http://127.0.0.1:8080/sse 上启动。

对于其他选项：

python kontxt_server.py --repo-path /path/to/your/codebase --host 0.0.0.0 --port 6900

关闭服务器

可以通过在运行服务器的终端中按 Ctrl+C 来停止服务器。服务器将尝试以 3 秒超时时间优雅地关闭。

从客户端连接到服务器（Cursor 示例）

一旦您的服务器正在运行，您可以通过编辑您的 ~/.cursor/mcp.json 文件将 Cursor 连接到它：

{
  "mcpServers": {
    "kontxt-server": {
      "serverType": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

PS: 记住始终在 Cursor 设置或其他客户端上刷新 MCP 服务器，以通过 sse 连接到 MCP

替代方案：使用 stdio 传输运行

如果您更喜欢让客户端启动和管理服务器进程：

python kontxt_server.py --repo-path /path/to/your/codebase --transport stdio

对于此模式，请像这样配置您的 ~/.cursor/mcp.json 文件：

{
  "mcpServers": {
    "kontxt-server": {
      "serverType": "stdio",
      "command": "python",
      "args": ["/absolute/path/to/kontxt_server.py", "--repo-path", "/absolute/path/to/your/codebase", "--transport", "stdio"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}