Onyx MCP Server

Name: Onyx MCP Server
Author: lupuletic

lupuletic

开始使用源码仓库

Connects agents to an Onyx knowledge base for semantic search over documents and chat.

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

claude mcp add onyx --env ONYX_API_TOKEN='<ONYX_API_TOKEN>' --env ONYX_API_URL='<ONYX_API_URL>' -- npx -y @smithery/cli install @lupuletic/onyx-mcp-server --client claude

~/.codex/config.toml

[mcp_servers.onyx]
command = "npx"
args = ["-y", "@smithery/cli", "install", "@lupuletic/onyx-mcp-server", "--client", "claude"]
env = { ONYX_API_TOKEN = "<ONYX_API_TOKEN>", ONYX_API_URL = "<ONYX_API_URL>" }

# codex mcp add onyx --env ONYX_API_TOKEN='<ONYX_API_TOKEN>' --env ONYX_API_URL='<ONYX_API_URL>' -- npx -y @smithery/cli install @lupuletic/onyx-mcp-server --client claude

~/.cursor/mcp.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "onyx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

需要的环境变量

ONYX_API_TOKEN
ONYX_API_URL

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

需要的环境变量

相关推荐