GitNexus MCP最小权限配置指南只读模式与仓库白名单全解析【免费下载链接】GitNexusGitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a git repository (Github, Gitlab, Azure, Local) or ZIP file, and get an interactive knowledge graph with a built in Graph RAG Agent. Perfect for code exploration项目地址: https://gitcode.com/GitHub_Trending/gi/GitNexusGitNexus 是一款零服务器代码智能引擎Zero-Server Code Intelligence Engine把 Git 仓库或 ZIP 文件丢进去就能在本地获得交互式知识图谱和内置的 Graph RAG Agent。它的 MCP 服务器默认会把注册表里所有已索引仓库暴露给 AI 编程助手并包含图变更等写操作能力。在生产或团队协作场景中这种全量开放并不安全。本文将手把手带你用两个环境变量完成GitNexus MCP 最小权限配置开启只读模式、设置仓库白名单让 AI 助手只能看且只能看被允许的仓库。上图展示了 Kilo Code 中接入 GitNexus MCP 服务器后的效果——gitnexus 已连接并可用。接下来我们来看如何收敛它的权限。为什么 GitNexus MCP 需要最小权限配置GitNexus 通过gitnexus mcp命令启动 MCP 服务器stdio 或 HTTP 模式启动逻辑位于 gitnexus/src/cli/mcp.ts。默认行为有两个大开能力开放除了查询、影响面分析等只读工具外还暴露cypher原生查询、图变更、跨仓库 group 路由等能力仓库开放全局注册表里所有已索引仓库都能被 AI 助手访问。如果让不受信的提示词例如处理来路不明的 PR 时驱动这个服务器风险就很直观越权读取其他仓库、篡改本地图谱。最小权限配置的思路就是先锁能力再锁范围。一键开启 GitNexus MCP 只读模式设置环境变量GITNEXUS_MCP_READ_ONLY1后再启动 MCP 服务器即可GITNEXUS_MCP_READ_ONLY1 gitnexus mcp开启后GitNexus 会做三件事实现见 gitnexus/src/mcp/read-only-policy.ts只暴露经过验证的单仓库只读工具例如list_repos、query、context、impact、explain、trace、pdg_query、route_map、api_impact、detect_changes、shape_check等以及别名search、explore、overview拒绝写与越界能力cypher原生查询、图变更rename 等、group 系列工具在能力发现阶段就被剔除即便被强行调用也会在分发到后端之前被拦截报错自动清洁工具描述工具说明和资源文档里关于 group 路由、跨仓库功能的段落会被抹掉避免 AI 助手被诱导去调用不存在的能力。细节上还有几个值得知道的行为行为说明取值校验只接受0或1其他值或空字符串以外的非法值直接启动失败group路由只读模式下repo参数以开头的组路由被禁止组专属参数crossDepth、subgroup参数会触发报错组资源gitnexus://group/...资源 URI 一律拒绝 只读模式不是简单的过滤工具列表——它同时修改了暴露给 AI 的工具 schema删掉组相关参数保证 AI 看到的契约和实际可执行的契约完全一致。如何配置 GitNexus 仓库白名单只解决能做什么还不够还要解决能碰哪些仓库。GitNexus 提供两个环境变量实现见 gitnexus/src/mcp/repository-policy.ts步骤 1用 GITNEXUS_MCP_ALLOWED_REPOS 圈定可见仓库逗号分隔填写注册表中的规范仓库名或绝对索引路径条目会自动去空格、解析、去重GITNEXUS_MCP_ALLOWED_REPOSapi-server,frontend gitnexus mcp白名单生效后list_repos只会返回白名单内的仓库AI 助手根本看不到其余仓库的存在任何工具调用、资源读取gitnexus://repo/...都会先过白名单未授权仓库统一返回Repository is not available through this MCP server.不会泄露具体原因白名单下所有group_*工具与组资源直接不可用白名单恰好只有一个仓库时它自动成为默认仓库调用方可以省略repo参数有多个则必须显式指定。步骤 2可选用 GITNEXUS_MCP_DEFAULT_REPO 锁定默认仓库当白名单里有多个仓库、但你希望不带repo参数的调用永远落在某个仓库上GITNEXUS_MCP_ALLOWED_REPOSapi-server,frontend \ GITNEXUS_MCP_DEFAULT_REPOapi-server \ gitnexus mcp注意默认仓库必须在白名单内否则启动直接失败。只设置GITNEXUS_MCP_DEFAULT_REPO而不设白名单则只选默认不限范围——显式指定其他仓库仍然合法。启动时的配置校验GitNexus 采取快速失败策略以下情况都会在 stdio/HTTP 开始服务之前报错退出白名单条目为空、指向不存在的仓库、名称在注册表中产生歧义、默认仓库不在白名单内。这类严格校验避免了服务起来了但行为不可预测的尴尬局面。⚠️ 一个小坑如果某个仓库的名称在注册表里重复例如两个目录下有同名仓库白名单必须用绝对路径指定否则会以歧义失败。组合使用最安全的 GitNexus MCP 配置把两个机制叠加就是推荐的最小权限基线GITNEXUS_MCP_READ_ONLY1 \ GITNEXUS_MCP_ALLOWED_REPOSapi-server,frontend \ GITNEXUS_MCP_DEFAULT_REPOapi-server \ gitnexus mcp此时 AI 助手获得的能力被压缩为只能读、只能读 api-server 和 frontend、缺省落在 api-server。这正是能力最小化 范围最小化的完整落地也适用于团队共享的 MCP 服务HTTP 模式下策略同样生效且内置了鉴权 token 支持见 gitnexus/src/mcp/http-transport.ts。常见问题快速排查现象原因与解法启动报错GITNEXUS_MCP_READ_ONLY must be 0 or 1变量被设成了其他值改成1开启或0关闭MCP repository configuration contains an invalid repository selection白名单里的仓库名不存在于注册表先用gitnexus list核对名称The MCP default repository is not in the configured allowlist默认仓库不在白名单内把它加进GITNEXUS_MCP_ALLOWED_REPOSSpecify an explicit repo because multiple repositories are allowed白名单有多个且无默认仓库调用时带上repo参数或配置默认仓库AI 助手仍试图调用cypher只读模式下描述已抹除该能力若仍出现确认变量在MCP 服务器进程的环境中生效而非客户端 关键提醒这些环境变量作用于启动 MCP 服务器的那一侧你的 shell / 容器 / 服务编排而不是 AI 客户端的环境。写在最后GitNexus 的 MCP 权限体系设计得相当克制两个环境变量分别管住能力和范围启动即校验、拒绝即不泄露、描述与实际契约保持一致。对新手来说只需记住一句话——READ_ONLY1管只读ALLOWED_REPOS管白名单默认仓库别忘了放进白名单。更多环境变量一览可参阅项目根目录 README.md 的 Environment Variables 表格相关策略实现的测试覆盖在 gitnexus/test/unit/mcp-read-only.test.ts 与 gitnexus/test/unit/mcp-repository-policy.test.ts 中可以对照行为理解每一条拦截规则。【免费下载链接】GitNexusGitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a git repository (Github, Gitlab, Azure, Local) or ZIP file, and get an interactive knowledge graph with a built in Graph RAG Agent. Perfect for code exploration项目地址: https://gitcode.com/GitHub_Trending/gi/GitNexus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 GitNexus MCP最小权限配置指南：只读模式与仓库白名单全解析
GitNexus MCP最小权限配置指南只读模式与仓库白名单全解析【免费下载链接】GitNexusGitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a git repository (Github, Gitlab, Azure, Local) or ZIP file, and get an interactive knowledge graph with a built in Graph RAG Agent. Perfect for code exploration项目地址: https://gitcode.com/GitHub_Trending/gi/GitNexusGitNexus 是一款零服务器代码智能引擎Zero-Server Code Intelligence Engine把 Git 仓库或 ZIP 文件丢进去就能在本地获得交互式知识图谱和内置的 Graph RAG Agent。它的 MCP 服务器默认会把注册表里所有已索引仓库暴露给 AI 编程助手并包含图变更等写操作能力。在生产或团队协作场景中这种全量开放并不安全。本文将手把手带你用两个环境变量完成GitNexus MCP 最小权限配置开启只读模式、设置仓库白名单让 AI 助手只能看且只能看被允许的仓库。上图展示了 Kilo Code 中接入 GitNexus MCP 服务器后的效果——gitnexus 已连接并可用。接下来我们来看如何收敛它的权限。为什么 GitNexus MCP 需要最小权限配置GitNexus 通过gitnexus mcp命令启动 MCP 服务器stdio 或 HTTP 模式启动逻辑位于 gitnexus/src/cli/mcp.ts。默认行为有两个大开能力开放除了查询、影响面分析等只读工具外还暴露cypher原生查询、图变更、跨仓库 group 路由等能力仓库开放全局注册表里所有已索引仓库都能被 AI 助手访问。如果让不受信的提示词例如处理来路不明的 PR 时驱动这个服务器风险就很直观越权读取其他仓库、篡改本地图谱。最小权限配置的思路就是先锁能力再锁范围。一键开启 GitNexus MCP 只读模式设置环境变量GITNEXUS_MCP_READ_ONLY1后再启动 MCP 服务器即可GITNEXUS_MCP_READ_ONLY1 gitnexus mcp开启后GitNexus 会做三件事实现见 gitnexus/src/mcp/read-only-policy.ts只暴露经过验证的单仓库只读工具例如list_repos、query、context、impact、explain、trace、pdg_query、route_map、api_impact、detect_changes、shape_check等以及别名search、explore、overview拒绝写与越界能力cypher原生查询、图变更rename 等、group 系列工具在能力发现阶段就被剔除即便被强行调用也会在分发到后端之前被拦截报错自动清洁工具描述工具说明和资源文档里关于 group 路由、跨仓库功能的段落会被抹掉避免 AI 助手被诱导去调用不存在的能力。细节上还有几个值得知道的行为行为说明取值校验只接受0或1其他值或空字符串以外的非法值直接启动失败group路由只读模式下repo参数以开头的组路由被禁止组专属参数crossDepth、subgroup参数会触发报错组资源gitnexus://group/...资源 URI 一律拒绝 只读模式不是简单的过滤工具列表——它同时修改了暴露给 AI 的工具 schema删掉组相关参数保证 AI 看到的契约和实际可执行的契约完全一致。如何配置 GitNexus 仓库白名单只解决能做什么还不够还要解决能碰哪些仓库。GitNexus 提供两个环境变量实现见 gitnexus/src/mcp/repository-policy.ts步骤 1用 GITNEXUS_MCP_ALLOWED_REPOS 圈定可见仓库逗号分隔填写注册表中的规范仓库名或绝对索引路径条目会自动去空格、解析、去重GITNEXUS_MCP_ALLOWED_REPOSapi-server,frontend gitnexus mcp白名单生效后list_repos只会返回白名单内的仓库AI 助手根本看不到其余仓库的存在任何工具调用、资源读取gitnexus://repo/...都会先过白名单未授权仓库统一返回Repository is not available through this MCP server.不会泄露具体原因白名单下所有group_*工具与组资源直接不可用白名单恰好只有一个仓库时它自动成为默认仓库调用方可以省略repo参数有多个则必须显式指定。步骤 2可选用 GITNEXUS_MCP_DEFAULT_REPO 锁定默认仓库当白名单里有多个仓库、但你希望不带repo参数的调用永远落在某个仓库上GITNEXUS_MCP_ALLOWED_REPOSapi-server,frontend \ GITNEXUS_MCP_DEFAULT_REPOapi-server \ gitnexus mcp注意默认仓库必须在白名单内否则启动直接失败。只设置GITNEXUS_MCP_DEFAULT_REPO而不设白名单则只选默认不限范围——显式指定其他仓库仍然合法。启动时的配置校验GitNexus 采取快速失败策略以下情况都会在 stdio/HTTP 开始服务之前报错退出白名单条目为空、指向不存在的仓库、名称在注册表中产生歧义、默认仓库不在白名单内。这类严格校验避免了服务起来了但行为不可预测的尴尬局面。⚠️ 一个小坑如果某个仓库的名称在注册表里重复例如两个目录下有同名仓库白名单必须用绝对路径指定否则会以歧义失败。组合使用最安全的 GitNexus MCP 配置把两个机制叠加就是推荐的最小权限基线GITNEXUS_MCP_READ_ONLY1 \ GITNEXUS_MCP_ALLOWED_REPOSapi-server,frontend \ GITNEXUS_MCP_DEFAULT_REPOapi-server \ gitnexus mcp此时 AI 助手获得的能力被压缩为只能读、只能读 api-server 和 frontend、缺省落在 api-server。这正是能力最小化 范围最小化的完整落地也适用于团队共享的 MCP 服务HTTP 模式下策略同样生效且内置了鉴权 token 支持见 gitnexus/src/mcp/http-transport.ts。常见问题快速排查现象原因与解法启动报错GITNEXUS_MCP_READ_ONLY must be 0 or 1变量被设成了其他值改成1开启或0关闭MCP repository configuration contains an invalid repository selection白名单里的仓库名不存在于注册表先用gitnexus list核对名称The MCP default repository is not in the configured allowlist默认仓库不在白名单内把它加进GITNEXUS_MCP_ALLOWED_REPOSSpecify an explicit repo because multiple repositories are allowed白名单有多个且无默认仓库调用时带上repo参数或配置默认仓库AI 助手仍试图调用cypher只读模式下描述已抹除该能力若仍出现确认变量在MCP 服务器进程的环境中生效而非客户端 关键提醒这些环境变量作用于启动 MCP 服务器的那一侧你的 shell / 容器 / 服务编排而不是 AI 客户端的环境。写在最后GitNexus 的 MCP 权限体系设计得相当克制两个环境变量分别管住能力和范围启动即校验、拒绝即不泄露、描述与实际契约保持一致。对新手来说只需记住一句话——READ_ONLY1管只读ALLOWED_REPOS管白名单默认仓库别忘了放进白名单。更多环境变量一览可参阅项目根目录 README.md 的 Environment Variables 表格相关策略实现的测试覆盖在 gitnexus/test/unit/mcp-read-only.test.ts 与 gitnexus/test/unit/mcp-repository-policy.test.ts 中可以对照行为理解每一条拦截规则。【免费下载链接】GitNexusGitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a git repository (Github, Gitlab, Azure, Local) or ZIP file, and get an interactive knowledge graph with a built in Graph RAG Agent. Perfect for code exploration项目地址: https://gitcode.com/GitHub_Trending/gi/GitNexus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考