[{"_1":2,"_318":-5,"_319":-5},"loaderData",{"_3":4,"_26":27,"_28":29,"_30":31,"_235":236},"root",{"_5":6,"_14":15},"toasts",[7],{"_8":9,"_10":11,"_12":13},"uid","45e98edb-911a-47a9-988d-76484c38d723","title","This MCP server does not support inspection","type","error","visitor",{"_16":17,"_18":19},"viewportWidth",1280,"visitorSession",{"_20":21,"_23":-5,"_8":24,"_25":-5},"attributes",[22],"BOT","membership","J9fS52nfcN","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_32":-5,"_33":34,"_35":36,"_154":155},"githubUser","maintainer",false,"mcpServer",{"_37":38,"_39":40,"_20":56,"_63":64,"_65":64,"_66":67,"_72":73,"_95":96,"_99":100,"_101":34,"_102":103,"_82":83,"_127":87,"_128":-5,"_129":-5,"_130":-5,"_131":132,"_139":-5,"_140":141,"_146":-5,"_110":83,"_147":148,"_150":-5,"_8":151,"_152":153},"addedAt",["D",1742751721528],"argumentsJsonSchema",{"_41":42,"_53":54,"_12":55},"properties",{"_43":44,"_50":51},"ONYX_API_URL",{"_45":46,"_47":48,"_12":49},"default","http://localhost:8080/api","description","The URL of your Onyx API instance","string","ONYX_API_TOKEN",{"_47":52,"_12":49},"Your Onyx API token for authentication","required",[50],"object",[57,58,59,60,61,62,57],"author:claimed","category:search","category:knowledge-and-memory","hosting:local-only","language:typescript","license_grade:a","descriptionMarkdown","Connect your MCP-compatible clients to Onyx AI knowledge bases for enhanced semantic search and chat capabilities. Retrieve relevant context from your documents seamlessly, enabling powerful interactions and comprehensive answers. Streamline knowledge management and improve access to information acr","descriptionPlainText","githubProject",{"_68":69,"_70":71},"readme","# Onyx MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![npm version](https://img.shields.io/npm/v/onyx-mcp-server.svg)](https://www.npmjs.com/package/onyx-mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/onyx-mcp-server.svg)](https://www.npmjs.com/package/onyx-mcp-server)\n[![smithery badge](https://smithery.ai/badge/@lupuletic/onyx-mcp-server)](https://smithery.ai/server/@lupuletic/onyx-mcp-server)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/lupuletic/onyx-mcp-server/blob/main/CONTRIBUTING.md)\n\n> A Model Context Protocol (MCP) server for seamless integration with Onyx AI knowledge bases.\n\nThis 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.\n\n $\"image\"$ \n\n\n## Features\n\n- **Enhanced Search**: Semantic search across your Onyx document sets with LLM relevance filtering\n- **Context Window Retrieval**: Retrieve chunks above and below the matching chunk for better context\n- **Full Document Retrieval**: Option to retrieve entire documents instead of just chunks\n- **Chat Integration**: Use Onyx's powerful chat API with LLM + RAG for comprehensive answers\n- **Configurable Document Set Filtering**: Target specific document sets for more relevant results\n\n## Installation\n\n### Installing via Smithery\n\nTo install Onyx MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@lupuletic/onyx-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @lupuletic/onyx-mcp-server --client claude\n```\n\n### Prerequisites\n\n- Node.js (v16 or higher)\n- An Onyx instance with API access\n- An Onyx API token\n\n### Setup\n\n1. Clone the repository:\n ```bash\n git clone https://github.com/lupuletic/onyx-mcp-server.git\n cd onyx-mcp-server\n ```\n\n2. Install dependencies:\n ```bash\n npm install\n ```\n\n3. Build the server:\n ```bash\n npm run build\n ```\n\n4. Configure your Onyx API Token:\n ```bash\n export ONYX_API_TOKEN=\"your-api-token-here\"\n export ONYX_API_URL=\"http://localhost:8080/api\" # Adjust as needed\n ```\n\n5. Start the server:\n ```bash\n npm start\n ```\n\n## Configuring MCP Clients\n\n### For Claude Desktop App\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"onyx-search\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/onyx-mcp-server/build/index.js\"],\n \"env\": {\n \"ONYX_API_TOKEN\": \"your-api-token-here\",\n \"ONYX_API_URL\": \"http://localhost:8080/api\"\n },\n \"disabled\": false,\n \"alwaysAllow\": []\n }\n }\n}\n```\n\n### For Claude in VSCode (Cline)\n\nAdd to your Cline MCP settings file:\n\n```json\n{\n \"mcpServers\": {\n \"onyx-search\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/onyx-mcp-server/build/index.js\"],\n \"env\": {\n \"ONYX_API_TOKEN\": \"your-api-token-here\",\n \"ONYX_API_URL\": \"http://localhost:8080/api\"\n },\n \"disabled\": false, \n \"alwaysAllow\": []\n }\n }\n}\n```\n\n### For Other MCP Clients\n\nConsult your MCP client's documentation for how to add a custom MCP server. You'll need to provide:\n\n- The command to run the server (`node`)\n- The path to the built server file (`/path/to/onyx-mcp-server/build/index.js`)\n- Environment variables for `ONYX_API_TOKEN` and `ONYX_API_URL`\n\n## Available Tools\n\nOnce configured, your MCP client will have access to two powerful tools:\n\n### 1. Search Tool\n\nThe `search_onyx` tool provides direct access to Onyx's search capabilities with enhanced context retrieval:\n\n```\n\nonyx-search\nsearch_onyx\n\n{\n \"query\": \"customer onboarding process\",\n \"documentSets\": [\"Company Policies\", \"Training Materials\"],\n \"maxResults\": 3,\n \"chunksAbove\": 1,\n \"chunksBelow\": 1,\n \"retrieveFullDocuments\": true\n}\n\n\n```\n\nParameters:\n- `query` (required): The topic to search for\n- `documentSets` (optional): List of document set names to search within (empty for all)\n- `maxResults` (optional): Maximum number of results to return (default: 5, max: 10)\n- `chunksAbove` (optional): Number of chunks to include above the matching chunk (default: 1)\n- `chunksBelow` (optional): Number of chunks to include below the matching chunk (default: 1)\n- `retrieveFullDocuments` (optional): Whether to retrieve full documents instead of just chunks (default: false)\n\n### 2. Chat Tool\n\nThe `chat_with_onyx` tool leverages Onyx's powerful chat API with LLM + RAG for comprehensive answers:\n\n```\n\nonyx-search\nchat_with_onyx\n\n{\n \"query\": \"What is our company's policy on remote work?\",\n \"personaId\": 15,\n \"documentSets\": [\"Company Policies\", \"HR Documents\"],\n \"chatSessionId\": \"optional-existing-session-id\"\n}\n\n\n```\n\nParameters:\n- `query` (required): The question to ask Onyx\n- `personaId` (optional): The ID of the persona to use (default: 15)\n- `documentSets` (optional): List of document set names to search within (empty for all)\n- `chatSessionId` (optional): Existing chat session ID to continue a conversation\n\n#### Chat Sessions\n\nThe chat tool supports maintaining conversation context across multiple interactions. After the first call, the response will include a `chat_session_id` in the metadata. You can pass this ID in subsequent calls to maintain context.\n\n## Choosing Between Search and Chat\n\n- **Use Search When**: You need specific, targeted information from documents and want to control exactly how much context is retrieved.\n- **Use Chat When**: You need comprehensive answers that combine information from multiple sources, or when you want the LLM to synthesize information for you.\n\nFor the best results, you can use both tools in combination - search for specific details and chat for comprehensive understanding.\n\n## Use Cases\n\n- **Knowledge Management**: Access your organization's knowledge base through any MCP-compatible interface\n- **Customer Support**: Help support agents quickly find relevant information\n- **Research**: Conduct deep research across your organization's documents\n- **Training**: Provide access to training materials and documentation\n- **Policy Compliance**: Ensure teams have access to the latest policies and procedures\n\n## Development\n\n### Running in Development Mode\n\n```bash\nnpm run dev\n```\n\n### Committing Changes\n\nThis project enforces the [Conventional Commits](https://www.conventionalcommits.org/) specification for all commit messages. To make this easier, we provide an interactive commit tool:\n\n```bash\nnpm run commit\n```\n\nThis will guide you through creating a properly formatted commit message. Alternatively, you can write your own commit messages following the conventional format:\n\n```\n[optional scope]: \n\n[optional body]\n\n[optional footer(s)]\n```\n\nWhere `type` is one of: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert\n\n### Building for Production\n\n```bash\nnpm run build\n```\n\n### Testing\n\nRun the test suite:\n\n```bash\nnpm test\n```\n\nRun tests with coverage:\n\n```bash\nnpm run test:coverage\n```\n\n### Linting\n\n```bash\nnpm run lint\n```\n\nFix linting issues:\n\n```bash\nnpm run lint:fix\n```\n\n## Continuous Integration\n\nThis project uses GitHub Actions for continuous integration and deployment. The CI pipeline runs on every push to the main branch and on pull requests. It performs the following checks:\n\n- Linting\n- Building\n- Testing\n- Code coverage reporting\n\n### Automated Version Bumping and Publishing\n\nWhen a PR is merged to the main branch, the project automatically determines the appropriate version bump type and publishes to npm. The system analyzes both PR titles and commit messages to determine the version bump type.\n\n1. **PR Title Validation**: All PR titles are validated against the [Conventional Commits](https://www.conventionalcommits.org/) specification:\n - PR titles must start with a type (e.g., `feat:`, `fix:`, `docs:`)\n - This validation happens automatically when a PR is created or updated\n - PRs with invalid titles will fail the validation check\n\n2. **Commit Message Validation**: All commit messages are also validated against the conventional commits format:\n - Commit messages must start with a type (e.g., `feat:`, `fix:`, `docs:`)\n - This is enforced by git hooks that run when you commit\n - Commits with invalid messages will be rejected\n - Use `npm run commit` for an interactive commit message creation tool\n\n3. **Version Bump Determination**: The system analyzes both the PR title and commit messages to determine the appropriate version bump:\n - PR titles starting with `feat` or containing new features → minor version bump\n - PR titles starting with `fix` or containing bug fixes → patch version bump\n - PR titles containing `BREAKING CHANGE` or with an exclamation mark → major version bump\n - If the PR title doesn't indicate a specific bump type, the system analyzes commit messages\n - The highest priority bump type found in any commit message is used (major > minor > patch)\n - If no conventional commit prefixes are found, the system automatically defaults to a patch version bump without failing\n\n4. **Version Update and Publishing**:\n - Bumps the version in package.json according to semantic versioning\n - Commits and pushes the version change\n - Publishes the new version to npm\n\nThis automated process ensures consistent versioning based on the nature of the changes, following semantic versioning principles, and eliminates manual version management.\n\n## Contributing\n\nContributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for more details.\n\n## Security\n\nIf you discover a security vulnerability, please follow our [Security Policy](SECURITY.md).\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n\n\n

\n","url","https://github.com/lupuletic/onyx-mcp-server#readme","githubRepository",{"_74":75,"_76":77,"_78":79,"_80":81,"_82":83,"_84":85,"_89":90,"_91":92,"_94":90},"defaultBranch","main","fullName","lupuletic/onyx-mcp-server","githubTreeId",102611,"language","TypeScript","name","onyx-mcp-server","owner",{"_86":87,"_8":88},"login","lupuletic","Vded62Ox5l","recentStargazers",0,"spdxLicense",{"_82":93},"MIT License","stargazers","glamaJson",{"_97":98},"maintainers",[87],"id",3265,"inspectable","integrations",[104,114,121],{"_105":106,"_47":112,"_8":113},"brand",{"_107":108,"_82":109,"_110":111},"logoSvgPath","M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12","GitHub","slug","github","Hosted on GitHub with contribution guidelines and continuous integration through GitHub Actions","6sr05sv227",{"_105":115,"_47":119,"_8":120},{"_107":116,"_82":117,"_110":118},"M11.998,24c-0.321,0-0.641-0.084-0.922-0.247l-2.936-1.737c-0.438-0.245-0.224-0.332-0.08-0.383 c0.585-0.203,0.703-0.25,1.328-0.604c0.065-0.037,0.151-0.023,0.218,0.017l2.256,1.339c0.082,0.045,0.197,0.045,0.272,0l8.795-5.076 c0.082-0.047,0.134-0.141,0.134-0.238V6.921c0-0.099-0.053-0.192-0.137-0.242l-8.791-5.072c-0.081-0.047-0.189-0.047-0.271,0 L3.075,6.68C2.99,6.729,2.936,6.825,2.936,6.921v10.15c0,0.097,0.054,0.189,0.139,0.235l2.409,1.392 c1.307,0.654,2.108-0.116,2.108-0.89V7.787c0-0.142,0.114-0.253,0.256-0.253h1.115c0.139,0,0.255,0.112,0.255,0.253v10.021 c0,1.745-0.95,2.745-2.604,2.745c-0.508,0-0.909,0-2.026-0.551L2.28,18.675c-0.57-0.329-0.922-0.945-0.922-1.604V6.921 c0-0.659,0.353-1.275,0.922-1.603l8.795-5.082c0.557-0.315,1.296-0.315,1.848,0l8.794,5.082c0.57,0.329,0.924,0.944,0.924,1.603 v10.15c0,0.659-0.354,1.273-0.924,1.604l-8.794,5.078C12.643,23.916,12.324,24,11.998,24z M19.099,13.993 c0-1.9-1.284-2.406-3.987-2.763c-2.731-0.361-3.009-0.548-3.009-1.187c0-0.528,0.235-1.233,2.258-1.233 c1.807,0,2.473,0.389,2.747,1.607c0.024,0.115,0.129,0.199,0.247,0.199h1.141c0.071,0,0.138-0.031,0.186-0.081 c0.048-0.054,0.074-0.123,0.067-0.196c-0.177-2.098-1.571-3.076-4.388-3.076c-2.508,0-4.004,1.058-4.004,2.833 c0,1.925,1.488,2.457,3.895,2.695c2.88,0.282,3.103,0.703,3.103,1.269c0,0.983-0.789,1.402-2.642,1.402 c-2.327,0-2.839-0.584-3.011-1.742c-0.02-0.124-0.126-0.215-0.253-0.215h-1.137c-0.141,0-0.254,0.112-0.254,0.253 c0,1.482,0.806,3.248,4.655,3.248C17.501,17.007,19.099,15.91,19.099,13.993z","Node.js","node-dot-js","Runs as a Node.js-based MCP server to connect Onyx knowledge bases to MCP clients, enabling document search and retrieval functionality","23q5hemx06",{"_105":122,"_47":125,"_8":126},{"_107":123,"_82":124,"_110":124},"M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z","npm","Available as an npm package for easy installation and integration with Onyx knowledge bases","lcjbxh2f6w","namespace","npmPackage","prompts","redditPostForeignId","relatedMcpServerIds",[133,134,135,136,137,138],1317,334,1681,1457,2387,805,"resources","scores",{"_142":143,"_144":-5,"_145":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms",[149],"MACOS","tools","042c771hjy","updatedAt",["D",1742767297438],"meta",[156,158,160,167,170,172,175,178,181,184,187,189,192,195,197,199,201,203,205],{"_10":157},"onyx-mcp-server | Glama",{"_159":64,"_82":47},"content",{"_161":162,"_163":164,"_165":166},"href","https://glama.ai/mcp/servers/@lupuletic/onyx-mcp-server","rel","canonical","tagName","link",{"_159":83,"_168":169},"property","og:title",{"_159":64,"_168":171},"og:description",{"_159":173,"_168":174},"https://glama.ai/logo.png","og:logo",{"_159":176,"_168":177},"https://glama.ai/mcp/servers/@lupuletic/onyx-mcp-server/og-image","og:image",{"_159":179,"_168":180},"630","og:image:height",{"_159":182,"_168":183},"1200","og:image:width",{"_159":185,"_168":186},"website","og:type",{"_159":162,"_168":188},"og:url",{"_159":190,"_168":191},"ChatGPT alternative for power users","og:site_name",{"_159":193,"_82":194},"summary_large_image","twitter:card",{"_159":190,"_82":196},"twitter:title",{"_159":64,"_82":198},"twitter:description",{"_159":176,"_82":200},"twitter:image",{"_159":179,"_82":202},"twitter:image:height",{"_159":182,"_82":204},"twitter:image:width",{"_206":207},"script:ld+json",{"_208":209,"_210":211},"@context","http://schema.org","@graph",[212],{"_208":213,"_214":215,"_216":217},"https://schema.org","@type","BreadcrumbList","itemListElement",[218,225,229,233],{"_214":219,"_220":221,"_82":222,"_223":224},"ListItem","item","https://glama.ai/","Glama","position",1,{"_214":219,"_220":226,"_82":227,"_223":228},"https://glama.ai/mcp","MCP",2,{"_214":219,"_220":230,"_82":231,"_223":232},"https://glama.ai/mcp/servers","Servers",3,{"_214":219,"_220":162,"_82":83,"_223":234},4,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~branch/~/_route",{"_237":238,"_242":75,"_35":243,"_268":269,"_270":271},"blob",{"_159":239,"_240":241},"{\n \"extends\": \"./tsconfig.json\",\n \"compilerOptions\": {\n \"types\": [\"jest\", \"node\"],\n \"esModuleInterop\": true\n },\n \"include\": [\"src/**/*\", \"src/__tests__/**/*\"]\n}","fileName","tsconfig.test.json","branch",{"_37":244,"_39":245,"_20":250,"_63":64,"_65":64,"_66":251,"_72":252,"_95":255,"_99":100,"_101":34,"_102":257,"_82":83,"_127":87,"_128":-5,"_129":-5,"_130":-5,"_131":264,"_139":-5,"_140":265,"_146":-5,"_110":83,"_147":266,"_150":-5,"_8":151,"_152":267},["D",1742751721528],{"_41":246,"_53":249,"_12":55},{"_43":247,"_50":248},{"_45":46,"_47":48,"_12":49},{"_47":52,"_12":49},[50],[57,58,59,60,61,62,57],{"_68":69,"_70":71},{"_74":75,"_76":77,"_78":79,"_80":81,"_82":83,"_84":253,"_89":90,"_91":254,"_94":90},{"_86":87,"_8":88},{"_82":93},{"_97":256},[87],[258,260,262],{"_105":259,"_47":112,"_8":113},{"_107":108,"_82":109,"_110":111},{"_105":261,"_47":119,"_8":120},{"_107":116,"_82":117,"_110":118},{"_105":263,"_47":125,"_8":126},{"_107":123,"_82":124,"_110":124},[133,134,135,136,137,138],{"_142":143,"_144":-5,"_145":-5},[149],["D",1742767297438],"path","","treeMembers",[272,275,277,279,281,283,285,287,289,291,293,295,297,299,301,303,305,307,309,311,313,315,317],{"_268":273,"_12":274},"docs","tree",{"_268":276,"_12":274},".github",{"_268":278,"_12":274},".husky",{"_268":280,"_12":274},"src",{"_268":282,"_12":237},"CHANGELOG.md",{"_268":284,"_12":237},".clinerules",{"_268":286,"_12":237},"CODE_OF_CONDUCT.md",{"_268":288,"_12":237},"commitlint.config.js",{"_268":290,"_12":237},"CONTRIBUTING.md",{"_268":292,"_12":237},"Dockerfile",{"_268":294,"_12":237},".eslintrc.cjs",{"_268":296,"_12":237},".gitignore",{"_268":298,"_12":237},"glama.json",{"_268":300,"_12":237},"jest.config.cjs",{"_268":302,"_12":237},"LICENSE",{"_268":304,"_12":237},".npmignore",{"_268":306,"_12":237},"package.json",{"_268":308,"_12":237},"package-lock.json",{"_268":310,"_12":237},"README.md",{"_268":312,"_12":237},"SECURITY.md",{"_268":314,"_12":237},"smithery.yaml",{"_268":316,"_12":237},"tsconfig.json",{"_268":241,"_12":237},"actionData","errors"]