Onyx MCP Server

A Model Context Protocol (MCP) server for seamless integration with Onyx AI knowledge bases.

This MCP server connects any MCP-compatible client to your Onyx knowledge base, allowing you to search and retrieve relevant context from your documents. It provides a bridge between MCP clients and the Onyx API, enabling powerful semantic search and chat capabilities.

Features

• Enhanced Search: Semantic search across your Onyx document sets with LLM relevance filtering
• Context Window Retrieval: Retrieve chunks above and below the matching chunk for better context
• Full Document Retrieval: Option to retrieve entire documents instead of just chunks
• Chat Integration: Use Onyx’s powerful chat API with LLM + RAG for comprehensive answers
• Configurable Document Set Filtering: Target specific document sets for more relevant results

Installation

Installing via Smithery

To install Onyx MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @lupuletic/onyx-mcp-server --client claude

Prerequisites

• Node.js (v16 or higher)
• An Onyx instance with API access
• An Onyx API token

Setup

1. Clone the repository:

   git clone https://github.com/lupuletic/onyx-mcp-server.git
   cd onyx-mcp-server
   

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

4. Configure your Onyx API Token:

   export ONYX_API_TOKEN="your-api-token-here"
   export ONYX_API_URL="http://localhost:8080/api"  # Adjust as needed
   

5. Start the server:

   npm start
   

Configuring MCP Clients

For Claude Desktop App

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "onyx-search": {
      "command": "node",
      "args": ["/path/to/onyx-mcp-server/build/index.js"],
      "env": {
        "ONYX_API_TOKEN": "your-api-token-here",
        "ONYX_API_URL": "http://localhost:8080/api"
      },