GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
作者提供的说明(英文原文)
Read-only-first Sonatype Nexus Repository 3 inspection, audit and documentation.
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
选择你使用的 AI 应用,然后复制设置。
NEXUS_URL, NEXUS_USERNAME, NEXUS_PASSWORD, NEXUS_VERIFY_TLS, NEXUS_MCP_MODE, NEXUS_MCP_ENABLE_WRITE_TOOLS, NEXUS_MCP_ENABLE_RAW_API标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。
你需要
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json
{
"mcpServers": {
"nexus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NEXUS_URL",
"-e",
"NEXUS_USERNAME",
"-e",
"NEXUS_PASSWORD",
"-e",
"NEXUS_VERIFY_TLS",
"-e",
"NEXUS_MCP_MODE",
"-e",
"NEXUS_MCP_ENABLE_WRITE_TOOLS",
"-e",
"NEXUS_MCP_ENABLE_RAW_API",
"ghcr.io/oomchiller/nexus-mcp-server:0.2.1"
],
"env": {
"NEXUS_URL": "your-value",
"NEXUS_USERNAME": "your-value",
"NEXUS_PASSWORD": "your-value",
"NEXUS_VERIFY_TLS": "your-value",
"NEXUS_MCP_MODE": "your-value",
"NEXUS_MCP_ENABLE_WRITE_TOOLS": "your-value",
"NEXUS_MCP_ENABLE_RAW_API": "your-value"
}
}
}
}在终端中运行这条命令
claude mcp add nexus --env NEXUS_URL=your-value --env NEXUS_USERNAME=your-value --env NEXUS_PASSWORD=your-value --env NEXUS_VERIFY_TLS=your-value --env NEXUS_MCP_MODE=your-value --env NEXUS_MCP_ENABLE_WRITE_TOOLS=your-value --env NEXUS_MCP_ENABLE_RAW_API=your-value -- docker run -i --rm -e NEXUS_URL -e NEXUS_USERNAME -e NEXUS_PASSWORD -e NEXUS_VERIFY_TLS -e NEXUS_MCP_MODE -e NEXUS_MCP_ENABLE_WRITE_TOOLS -e NEXUS_MCP_ENABLE_RAW_API ghcr.io/oomchiller/nexus-mcp-server:0.2.1运行前请先填写空着的值。
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"nexus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NEXUS_URL",
"-e",
"NEXUS_USERNAME",
"-e",
"NEXUS_PASSWORD",
"-e",
"NEXUS_VERIFY_TLS",
"-e",
"NEXUS_MCP_MODE",
"-e",
"NEXUS_MCP_ENABLE_WRITE_TOOLS",
"-e",
"NEXUS_MCP_ENABLE_RAW_API",
"ghcr.io/oomchiller/nexus-mcp-server:0.2.1"
],
"env": {
"NEXUS_URL": "your-value",
"NEXUS_USERNAME": "your-value",
"NEXUS_PASSWORD": "your-value",
"NEXUS_VERIFY_TLS": "your-value",
"NEXUS_MCP_MODE": "your-value",
"NEXUS_MCP_ENABLE_WRITE_TOOLS": "your-value",
"NEXUS_MCP_ENABLE_RAW_API": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"nexus": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NEXUS_URL",
"-e",
"NEXUS_USERNAME",
"-e",
"NEXUS_PASSWORD",
"-e",
"NEXUS_VERIFY_TLS",
"-e",
"NEXUS_MCP_MODE",
"-e",
"NEXUS_MCP_ENABLE_WRITE_TOOLS",
"-e",
"NEXUS_MCP_ENABLE_RAW_API",
"ghcr.io/oomchiller/nexus-mcp-server:0.2.1"
],
"env": {
"NEXUS_URL": "your-value",
"NEXUS_USERNAME": "your-value",
"NEXUS_PASSWORD": "your-value",
"NEXUS_VERIFY_TLS": "your-value",
"NEXUS_MCP_MODE": "your-value",
"NEXUS_MCP_ENABLE_WRITE_TOOLS": "your-value",
"NEXUS_MCP_ENABLE_RAW_API": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。
你的选择通过 Cookie 保存在这台设备上,无需账户。
NEXUS_USERNAME envNEXUS_VERIFY_TLS envNEXUS_MCP_MODE envNEXUS_MCP_ENABLE_WRITE_TOOLS envNEXUS_MCP_ENABLE_RAW_API env这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日
注册名称已通过 GitHub 账户 oomchiller 验证,该账户拥有此仓库
我们还没有从 GitHub 读取这个仓库
我们还没有从 GitHub 读取这个仓库
它在你的电脑上运行,没有互联网端点
在你的电脑上运行,改用本地设置
它在你的电脑上运行;我们只能读取互联网端点的工具列表
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
你需要填写:NEXUS_URL, NEXUS_PASSWORD
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
GitHub 仓库最后更新于–,最新版本(0.2.1)于4天前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Docker。
同一分类中有:GitHub, Desktop Commander, Cloudflare MCP
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
MCP server for terminal commands, file operations, and process management
Cloudflare MCP servers
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
A Model Context Protocol server that lets AI assistants inspect, audit and document a Sonatype Nexus Repository Manager 3.x instance. It is read-only by default; administrative tools are not even listed unless you enable them.
flowchart LR
AI[MCP client] <-->|stdio / Streamable HTTP| Server[nexus-mcp-server] Server <-->|REST API| Nexus[Nexus Repository 3.x]
readOnlyHint, destructiveHint, idempotentHint and openWorldHint; outputs and logs redact the configured password and secret-looking keys.Used in production in read-only mode on Nexus Pro 3.96.1-01; partially verified on OSS 3.70. See docs/COMPATIBILITY.md.
The server is listed in the MCP Registry as io.github.oomchiller/nexus-mcp-server; registry-aware clients can install it from there. Manual setup:
docker run --rm -i \
-e NEXUS_URL=https://nexus.example.com \ -e NEXUS_USERNAME=readonly-user \ -e NEXUS_PASSWORD \ ghcr.io/oomchiller/nexus-mcp-server:0.2.1
Images are published for linux/amd64 and linux/arm64, run as an unprivileged user over stdio, and are configured through the environment only. Release digests are listed on the releases page.
{
"mcpServers": { "nexus": { "command": "uvx", "args": ["--from", "git+https://github.com/oomchiller/nexus-mcp-server@v0.2.1", "nexus-mcp-server"], "env": { "NEXUS_URL": "https://nexus.example.com", "NEXUS_USERNAME": "readonly-user", "NEXUS_PASSWORD": "change-me" } } } }
More client examples (Claude Desktop, Codex CLI, Gemini CLI) are in examples/.
Settings come from the environment or a .env file in the working directory.
| Variable | Default | Meaning |
|---|---|---|
NEXUS_URL | unset | Nexus base URL. Without it the server starts, and calls report that Nexus is not configured. |
NEXUS_USERNAME / NEXUS_PASSWORD | unset | Basic authentication. Use a read-only Nexus account. |
NEXUS_VERIFY_TLS | true | Verify the Nexus TLS certificate. |
NEXUS_CA_BUNDLE | unset | PEM file of CA certificates to trust instead of the public roots; needs NEXUS_VERIFY_TLS=true. |
NEXUS_TIMEOUT_SECONDS | 30 | HTTP timeout. |
NEXUS_ALLOWED_HOSTS | host of NEXUS_URL | Comma-separated hosts the client may contact. |
NEXUS_LOG_LEVEL | INFO | Log level (stderr). |
NEXUS_MCP_MODE | readonly | readonly, audit (same gates as readonly) or admin. |
NEXUS_MCP_ENABLE_WRITE_TOOLS | false | With admin, lists and allows the write tools. |
NEXUS_MCP_ENABLE_RAW_API | false | Lists nexus_api_call. |
NEXUS_MCP_RAW_API_GET_ONLY | false | Restrict nexus_api_call to GET. |
NEXUS_MCP_MAX_RAW_RESPONSE_BYTES | 1048576 | Largest Nexus response accepted. |
NEXUS_MCP_GRAPH_TTL_SECONDS | 60 | How long graph tools reuse one Knowledge Graph build; 0 rebuilds on every call. |
NEXUS_MCP_ENABLE_PROMPTS | true | Register prompts. |
NEXUS_MCP_ENABLE_RESOURCES | true | Register resources. |
Token authentication is not implemented.
The server does not read SSL_CERT_FILE or the system trust store. For a Nexus behind a private CA, set NEXUS_CA_BUNDLE rather than disabling verification. An unreadable bundle, or a bundle with verification disabled, stops the server at startup.
Gateways that run several instances side by side and prefix only tool names (Docker MCP Gateway) should set NEXUS_MCP_ENABLE_PROMPTS=false and NEXUS_MCP_ENABLE_RESOURCES=false.
--transport {stdio,sse,streamable-http} default stdio
--host HOST / --port PORT HTTP bind, default 127.0.0.1:8000, no authentication --nexus-url URL overrides NEXUS_URL --nexus-username USERNAME overrides NEXUS_USERNAME --verify-ssl / --no-verify-ssl overrides NEXUS_VERIFY_TLS --ca-bundle PATH overrides NEXUS_CA_BUNDLE
Keep NEXUS_PASSWORD in the environment, not on the command line.
| Group | Tools |
|---|---|
| Explanation | nexus_understand_architecture, nexus_explain_repository, nexus_explain_storage_strategy |
| Inventory and documentation | nexus_generate_inventory_json, nexus_generate_architecture_md, nexus_generate_repository_catalog_md, nexus_audit_repository_content |
| Audit | nexus_detect_architecture_smells, nexus_generate_audit_report |
| Drift | nexus_compare_live_state_with_declared_state |
| OpenAPI | nexus_openapi_list_operations, nexus_generate_capability_map |
Listed only when enabled:
| Tool | Requires |
|---|---|
nexus_api_call | NEXUS_MCP_ENABLE_RAW_API=true; paths are canonicalized and restricted to /service/rest/. |
nexus_delete_repository, nexus_run_task | NEXUS_MCP_MODE=admin and NEXUS_MCP_ENABLE_WRITE_TOOLS=true. |
Resources: nexus://instance/summary, nexus://repositories, nexus://blobstores, nexus://tasks, nexus://cleanup-policies, nexus://security/summary, nexus://architecture, nexus://knowledge_graph. Prompts: nexus_audit_prompt, nexus_iac_drift_prompt.
Limits worth knowing: drift compares repository name, format and type only; risk checks cover a small set of graph rules; findings are only as complete as the REST APIs visible to the account. Optional endpoints that are missing for version, edition or permission reasons appear as limitations, not failures.
NEXUS_ALLOWED_HOSTS and only paths relative to NEXUS_URL.uv sync --locked
uv run pytest uv run ruff check . && uv run ruff format --check . uv run mypy src tests
See CONTRIBUTING.md, ARCHITECTURE.md, DECISIONS.md and ROADMAP.md.
MIT; see LICENSE.