mekayelanik/gitnexus-mcp

GitNexus MCP Server

用于分布式部署的多架构Docker镜像

---

免责声明： 这是一个非官方Docker镜像。GitNexus由https://github.com/abhigyanpatwari/GitNexus%E5%BC%80%E5%8F%91%EF%BC%8C%E5%9F%BA%E4%BA%8Ehttps://github.com/abhigyanpatwari/GitNexus/blob/main/LICENSE%E8%AE%B8%E5%8F%AF%E3%80%82Docker%E6%89%93%E5%8C%85%E7%94%B1https://github.com/MekayelAnik%E7%8B%AC%E7%AB%8B%E7%BB%B4%E6%8A%A4%EF%BC%8C%E5%9F%BA%E4%BA%8EGPL v3许可。

---

目录

• 概述
• 支持的架构
• 可用标签
• 快速开始
• 配置
• GitNexus特定配置
• Wiki生成
• MCP客户端配置
• 网络配置
• 更新
• 故障排除
• 其他资源
• 支持与许可

---

请我喝杯咖啡

如果您觉得这个项目有价值，可以请我喝杯咖啡，激励我继续前进。

概述

https://github.com/abhigyanpatwari/GitNexus%E6%98%AF%E4%B8%80%E4%B8%AA%E4%BB%A3%E7%A0%81%E6%99%BA%E8%83%BDMCP%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E4%BD%BF%E7%94%A8LadybugDB%E6%9E%84%E5%BB%BA%E7%9F%A5%E8%AF%86%E5%9B%BE%E8%B0%B1%EF%BC%8C%E9%80%9A%E8%BF%87Tree-sitter%E7%B4%A2%E5%BC%95%E4%BB%93%E5%BA%93%EF%BC%8C%E7%94%9F%E6%88%90%E5%B5%8C%E5%85%A5%E5%90%91%E9%87%8F%EF%BC%8C%E5%88%9B%E5%BB%BAwiki%E6%96%87%E6%A1%A3%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9BAI%E9%A9%B1%E5%8A%A8%E7%9A%84%E4%BB%A3%E7%A0%81%E6%90%9C%E7%B4%A2%E3%80%82%E6%AD%A4%E9%95%9C%E5%83%8F%E5%B0%86%E5%85%B6%E6%89%93%E5%8C%85%E9%83%A8%E7%BD%B2%EF%BC%8C%E9%9B%86%E6%88%90HAProxy%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E4%BC%A0%E8%BE%93%E6%96%B9%E5%BC%8F%E3%80%81API%E5%AF%86%E9%92%A5%E8%AE%A4%E8%AF%81%E3%80%81CORS%E4%BB%A5%E5%8F%8AHTTP/1.1%E3%80%81HTTP/2%E3%80%81HTTP/3 (QUIC)。

主要特性

• 多架构支持 - 原生x86-64和ARM64
• 多种传输方式 - 可流式HTTP、SSE和WebSocket（通过环境变量选择）
• 自动分析 - 启动时索引数据目录中的所有仓库
• 自托管Web界面 - 与MCP使用相同端口的内置界面
• Wiki生成 - 通过OpenAI、Ollama、vLLM或兼容API实现AI驱动的wiki
• 安全设计 - API密钥认证、CORS、TLS终止、安全头
• 高性能 - ZSTD压缩加速部署

---

支持的架构

多架构镜像会自动为您的系统选择正确的架构。

---

可用标签

系统要求

• Docker引擎: 23.0+
• 内存: 最低1GB（嵌入向量需要2GB+）
• CPU: 单核（推荐多核）
• GPU: 可选NVIDIA显卡用于嵌入向量（参见GPU支持）
• 存储: 取决于仓库大小

重要: 不要在没有反向代理、SSL/TLS、认证和防火墙的情况下直接暴露到互联网。

---

快速开始

Docker Compose（推荐）

yaml
services:
  gitnexus-mcp:
    image: mekayelanik/gitnexus-mcp:latest
    container_name: gitnexus-mcp
    restart: unless-stopped
    ports:
      - "8010:8010"   # MCP + Web UI + API（均通过HAProxy）
    volumes:
      - /path/to/your/repos:/data:rw
      - gitnexus-registry:/home/node/.gitnexus   # 持久化索引注册表
      - gitnexus-cache:/home/node/.cache          # 持久化嵌入模型
    environment:
      - PORT=8010
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Dhaka
      - NODE_ENV=production
      - PROTOCOL=SHTTP
      - ENABLE_HTTPS=false
      - HTTP_VERSION_MODE=auto
      # GitNexus分析选项
      - DATA_DIR=/data
      - ANALYZE_FORCE=false
      - ANALYZE_VERBOSE=false
      # 可选：在HAProxy层要求Bearer令牌认证
      # - API_KEY=replace-with-strong-secret
      # 可选：Wiki生成（需要LLM API密钥）
      # - WIKI_ENABLED=true
      # - OPENAI_API_KEY=sk-...
      # - WIKI_MODEL=gpt-4o
    hostname: gitnexus-mcp
    domainname: local

volumes:
  gitnexus-registry:
    driver: local
  gitnexus-cache:
    driver: local

部署：

bash
docker compose up -d
docker compose logs -f gitnexus-mcp

Docker CLI

bash
docker volume create gitnexus-registry && docker volume create gitnexus-cache
docker run -d \
  --name=gitnexus-mcp \
  --restart=unless-stopped \
  -p 8010:8010 \
  -v /path/to/your/repos:/data:rw \
  -v gitnexus-registry:/home/node/.gitnexus \
  -v gitnexus-cache:/home/node/.cache \
  -e PORT=8010 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Dhaka \
  -e NODE_ENV=production \
  -e PROTOCOL=SHTTP \
  -e ENABLE_HTTPS=false \
  -e HTTP_VERSION_MODE=auto \
  -e DATA_DIR=/data \
  mekayelanik/gitnexus-mcp:latest

全功能Docker Compose（GPU + HTTPS + Wiki + 认证）

yaml
services:
  gitnexus-mcp:
    image: mekayelanik/gitnexus-mcp:latest
    container_name: gitnexus-mcp
    restart: unless-stopped
    ports:
      - "8010:8010"   # MCP + Web UI + API（均通过HAProxy）
    volumes:
      - /path/to/your/repos:/data:rw
      - gitnexus-registry:/home/node/.gitnexus   # 持久化索引注册表
      - gitnexus-cache:/home/node/.cache          # 持久化嵌入模型
      - /path/to/certs:/etc/haproxy/certs:ro      # TLS证书
      # GPU: 挂载主机CUDA库（无GPU时移除）
      - /usr/local/cuda/lib64:/usr/local/cuda/lib64:ro
    environment:
      # 核心配置
      - PORT=8010
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Dhaka
      - NODE_ENV=production
      # MCP传输方式（SHTTP、SSE或WS）
      - PROTOCOL=SHTTP
      # 安全配置
      - API_KEY=replace-with-a-strong-secret
      - CORS=*
      - ENABLE_HTTPS=true
      - TLS_CERT_PATH=/etc/haproxy/certs/server.crt
      - TLS_KEY_PATH=/etc/haproxy/certs/server.key
      - TLS_MIN_VERSION=TLSv1.3
      - HTTP_VERSION_MODE=auto
      # 仓库分析
      - DATA_DIR=/data
      - ANALYZE_FORCE=false
      - ANALYZE_SKILLS=true
      - ANALYZE_EMBEDDINGS=true
      - ANALYZE_VERBOSE=false
      # Wiki生成
      - WIKI_ENABLED=true
      - OPENAI_API_KEY=sk-your-key-here
      - WIKI_MODEL=gpt-4o-mini
      # Web界面
      - ENABLE_WEB_UI=true
    # NVIDIA GPU（可选 — 无GPU时移除）
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu, compute, utility]
    hostname: gitnexus-mcp
    domainname: local

volumes:
  gitnexus-registry:
    driver: local
  gitnexus-cache:
    driver: local

全功能Docker CLI（GPU + 认证）

bash
docker volume create gitnexus-registry && docker volume create gitnexus-cache
docker run -d \
  --name=gitnexus-mcp \
  --restart=unless-stopped \
  --gpus all \
  -p 8010:8010 \
  -v /path/to/your/repos:/data:rw \
  -v gitnexus-registry:/home/node/.gitnexus \
  -v gitnexus-cache:/home/node/.cache \
  -v /path/to/certs:/etc/haproxy/certs:ro \
  -v /usr/local/cuda/lib64:/usr/local/cuda/lib64:ro \
  -e PORT=8010 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Dhaka \
  -e NODE_ENV=production \
  -e PROTOCOL=SHTTP \
  -e API_KEY=replace-with-a-strong-secret \
  -e CORS='*' \
  -e ENABLE_HTTPS=true \
  -e TLS_CERT_PATH=/etc/haproxy/certs/server.crt \
  -e TLS_KEY_PATH=/etc/haproxy/certs/server.key \
  -e HTTP_VERSION_MODE=auto \
  -e DATA_DIR=/data \
  -e ANALYZE_SKILLS=true \
  -e ANALYZE_EMBEDDINGS=true \
  -e WIKI_ENABLED=true \
  -e OPENAI_API_KEY=sk-your-key-here \
  -e WIKI_MODEL=gpt-4o-mini \
  mekayelanik/gitnexus-mcp:latest

本地Ollama + GitNexus（Docker Compose）

yaml
services:
  gitnexus-mcp:
    image: mekayelanik/gitnexus-mcp:latest
    container_name: gitnexus-mcp
    restart: unless-stopped
    ports:
      - "8010:8010"
    volumes:
      - /path/to/your/repos:/data:rw
      - gitnexus-registry:/home/node/.gitnexus   # 持久化索引注册表
      - gitnexus-cache:/home/node/.cache          # 持久化嵌入模型
    environment:
      - PORT=8010
      - PROTOCOL=SHTTP
      - ENABLE_HTTPS=false
      - DATA_DIR=/data
      - ANALYZE_VERBOSE=false
      # 通过本地Ollama生成Wiki
      - WIKI_ENABLED=true
      - WIKI_BASE_URL=http://ollama:11434/v1
      - WIKI_MODEL=llama3
      - OPENAI_API_KEY=not-needed

  ollama:
    image: ollama/ollama:latest
    container_name: ollama
    restart: unless-stopped
    volumes:
      - ollama-data:/root/.ollama
    # 取消注释以启用GPU
    # deploy:
    #   resources:
    #     reservations:
    #       devices:
    #         - driver: nvidia
    #           count: all
    #           capabilities: [compute, utility]

volumes:
  gitnexus-registry:
    driver: local
  gitnexus-cache:
    driver: local
  ollama-data:

访问端点

所有服务通过单个端口（默认8010）通过HAProxy访问：

启用ENABLE_HTTPS=true时，使用TLS端点：

单端口架构： HAProxy将/mcp、/healthz路由到Supergateway；/api/*路由到GitNexus API；/*路由到Web界面。设置ENABLE_WEB_UI=false可进入仅MCP模式。

智能健康检查： 在分析/wiki阶段报告健康状态，避免误报不健康状态。

安全警告： 默认使用HTTP。生产环境应使用ENABLE_HTTPS=true并提供自己的证书。参见CERTIFICATE_SETUP_GUIDE.md。ARM设备：允许60-120秒初始化时间。

---

配置

卷

索引存储在每个仓库内的.gitnexus/目录中。/home/node/.gitnexus处的注册表存储指针。

完整环境变量参考

网络和端口

内部端口（INTERNAL_PORT=38011，WEB_UI_PORT=4747）由HAProxy使用；仅在容器内端口冲突时更改。静态文件服务器端口（39012）是固定的。

安全和TLS

| 变量 | 默认值 | 可能