Onyx MCP

Name: Onyx MCP
Author: ByWaleed

โดย ByWaleedรุ่น 0.2.1i★ –iรันบนเครื่อง

ชื่อใน registryio.github.ByWaleed/onyx-mcp

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Secure MCP access to Onyx search, chat, projects, and administration.

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: แชตและอีเมล
ต้องใส่ค่าเหล่านี้: ONYX_API_URL, ONYX_API_TOKEN

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: ONYX_API_URL, ONYX_API_TOKEN, ONYX_DEFAULT_PERSONA_ID, ONYX_MCP_ENABLE_WEB_FETCH, ONYX_MCP_WEB_FETCH_ALLOWLIST

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "onyx-mcp"
      ],
      "env": {
        "ONYX_API_URL": "ใส่ค่าของคุณ",
        "ONYX_API_TOKEN": "ใส่ค่าของคุณ",
        "ONYX_DEFAULT_PERSONA_ID": "ใส่ค่าของคุณ",
        "ONYX_MCP_ENABLE_WEB_FETCH": "ใส่ค่าของคุณ",
        "ONYX_MCP_WEB_FETCH_ALLOWLIST": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add onyx --env ONYX_API_URL='ใส่ค่าของคุณ' --env ONYX_API_TOKEN='ใส่ค่าของคุณ' --env ONYX_DEFAULT_PERSONA_ID='ใส่ค่าของคุณ' --env ONYX_MCP_ENABLE_WEB_FETCH='ใส่ค่าของคุณ' --env ONYX_MCP_WEB_FETCH_ALLOWLIST='ใส่ค่าของคุณ' -- npx -y onyx-mcp

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "onyx-mcp"
      ],
      "env": {
        "ONYX_API_URL": "ใส่ค่าของคุณ",
        "ONYX_API_TOKEN": "ใส่ค่าของคุณ",
        "ONYX_DEFAULT_PERSONA_ID": "ใส่ค่าของคุณ",
        "ONYX_MCP_ENABLE_WEB_FETCH": "ใส่ค่าของคุณ",
        "ONYX_MCP_WEB_FETCH_ALLOWLIST": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "onyx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "onyx-mcp"
      ],
      "env": {
        "ONYX_API_URL": "ใส่ค่าของคุณ",
        "ONYX_API_TOKEN": "ใส่ค่าของคุณ",
        "ONYX_DEFAULT_PERSONA_ID": "ใส่ค่าของคุณ",
        "ONYX_MCP_ENABLE_WEB_FETCH": "ใส่ค่าของคุณ",
        "ONYX_MCP_WEB_FETCH_ALLOWLIST": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

ONYX_API_URL จำเป็น env
Onyx API base URL, for example https://onyx.example.com/api
ONYX_API_TOKEN ความลับ จำเป็น env
Onyx Personal Access Token or API key
ONYX_DEFAULT_PERSONA_ID env
Default Onyx agent ID for new chats
ONYX_MCP_ENABLE_WEB_FETCH env
Enable web search and allowlisted URL fetching
ONYX_MCP_WEB_FETCH_ALLOWLIST env
Comma-separated hostnames permitted for HTTPS URL fetching

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 8 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub ByWaleed ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด แชตและอีเมลi

ดาวมากกว่า 0% ของอีก 1846 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 27% ของอีก 1846 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 1846 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Onyx MCP ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: ONYX_API_URL, ONYX_API_TOKEN

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.1) เข้า registry 2 เดือนที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Vexa, emailmd, MCP WhatsApp Cloud

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Vexa

โดย Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

รันบนคลาวด์★ 2,949Apache-2.0อัปเดต 2 เดือนที่ผ่านมา

ติดตั้ง

emailmd

โดย anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

บนเครื่องหรือคลาวด์★ 1,385MITอัปเดต 32 วันที่ผ่านมา

ติดตั้ง

MCP WhatsApp Cloud

โดย codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

รันบนเครื่อง★ 277MITอัปเดต 5 เดือนที่ผ่านมา

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Onyx MCP

MCP Registry name: io.github.ByWaleed/onyx-mcp

A comprehensive, secure Model Context Protocol server for Onyx, formerly Danswer.

This project exposes Onyx search, chat, agents, projects, documents, connectors, ingestion, and deployment-specific APIs to MCP clients. It is an independent community project and is not an official Onyx package.

Why This Server

Uses the current /chat/send-chat-message contract.
Defaults to Onyx's built-in assistant, persona 0.
Supports scoped Personal Access Tokens and legacy API keys.
Starts read-only.
Separately gates writes, administration, destructive actions, and raw API access.
Applies request timeouts and response-size limits.
Never logs authorization headers or tokens.
Includes an advanced raw API tool for deployment-specific endpoints.

Install

npx -y onyx-mcp@0.2.1

The pinned command is recommended for reproducible execution. Use npx -y onyx-mcp@latest only if you intentionally want automatic upgrades.

Versioned tarballs are attached to GitHub Releases. The previous scoped package, @bywaleed/onyx-mcp, is deprecated in favor of onyx-mcp.

Configuration

Required:

Variable	Description
`ONYX_API_URL`	Onyx API base URL, for example `https://onyx.example.com/api`
`ONYX_API_TOKEN`	Onyx PAT or API key

Optional:

Variable	Default	Description
`ONYX_DEFAULT_PERSONA_ID`	`0`	Default agent used for new chats
`ONYX_MCP_ENABLE_WRITE`	`false`	Registers tools that create or modify data
`ONYX_MCP_ENABLE_ADMIN`	`false`	Registers administrative tools
`ONYX_MCP_ENABLE_DESTRUCTIVE`	`false`	Registers destructive tools; write must also be enabled
`ONYX_MCP_ENABLE_RAW_API`	`false`	Registers the advanced raw API tool; admin access is also required
`ONYX_MCP_ENABLE_WEB_FETCH`	`false`	Registers web search and URL-fetching tools
`ONYX_MCP_WEB_FETCH_ALLOWLIST`	empty	Comma-separated hostnames allowed for HTTPS URL fetching
`ONYX_MCP_TIMEOUT_MS`	`30000`	Request timeout
`ONYX_MCP_MAX_RESPONSE_BYTES`	`1000000`	Maximum accepted response body
`ONYX_MCP_MAX_CONCURRENCY`	`8`	Maximum concurrent requests to Onyx
`ONYX_MCP_MAX_QUEUE`	`100`	Maximum requests waiting for a concurrency slot

Onyx still enforces the permissions attached to the supplied token. Enabling a profile cannot grant additional Onyx privileges.

OpenCode

"mcp": { "onyx": { "type": "local", "command": ["npx", "-y", "onyx-mcp@0.2.1"], "environment": { "ONYX_API_URL": "https://onyx.example.com/api", "ONYX_API_TOKEN": "{env:ONYX_API_TOKEN}" }, "enabled": true } } }

Claude Desktop

"mcpServers": { "onyx": { "command": "npx", "args": ["-y", "onyx-mcp@0.2.1"], "env": { "ONYX_API_URL": "https://onyx.example.com/api", "ONYX_API_TOKEN": "your-token" } } } }

Tool Profiles

The read-only profile includes health, identity, permissions, search, chat history, agents, projects, files, tools, document sets, and connector status.

The write profile adds chat creation, chat messages, feedback, and project updates.

The admin profile adds connector, credential, user, agent, and direct-ingestion administration.

The destructive profile adds individually confirmed deletion tools. Bulk deletion is intentionally not exposed as a first-class tool.

The raw API profile adds onyx_api_request. It covers APIs specific to an Onyx edition or version. Every raw request requires the admin profile. Every non-GET request also requires write and destructive access plus confirmation because arbitrary endpoint semantics cannot be inferred safely.

Tools

The default profile provides health, version, identity, permission, indexed search, agent, chat-history, project, file, document-set, tool, source, and connector-status tools. Write mode adds chat, feedback, and project mutations. Admin mode adds connector, credential, user, agent, and ingestion tools. Web search and URL fetching require a separate web-fetch opt-in. URL fetching accepts only HTTPS destinations matching the configured hostname allowlist; Onyx must also validate redirects and resolved addresses to prevent DNS rebinding.

Run onyx_capabilities to inspect the active profile. MCP clients can also call tools/list for complete machine-readable schemas and safety annotations.

Authentication

Prefer an Onyx PAT with the smallest required scope:

read:search for search.
read:chat for chat history.
write:chat for chat creation and messages.

Some Onyx endpoints still use legacy role checks and need an unrestricted PAT or API key. Use a separate administrative server configuration for those operations.

Treat client configuration files as sensitive when they contain a token. Use a dedicated least-privilege token and restrict file permissions to your user account.

Development

npm ci

npm run verify

Compatibility

Component	Supported
Node.js	20 and 22
MCP SDK/protocol	TypeScript SDK 1.x, MCP through `2025-11-25`
Onyx	Current community and enterprise APIs; tested against the repository version documented in releases
Transport	Local stdio

The server uses non-streaming Onyx chat responses for a stable MCP result. Onyx editions and releases expose different administrative routes. The raw API tool provides an escape hatch while first-class tools remain curated and safe. MCP SDK 2.x migration is planned as a separate breaking compatibility release.

Support And Security

Usage questions: GitHub Discussions
Bugs and feature requests: GitHub Issues
Vulnerabilities: private security advisory
Release history: CHANGELOG.md
Maintainer release process: RELEASING.md
MCP Registry metadata: server.json

License

MIT

Onyx MCP

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด แชตและอีเมลi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Vexa

emailmd

MCP WhatsApp Cloud

README จากผู้ทำ

Onyx MCP

Why This Server

Install

Configuration

OpenCode

Claude Desktop

Tool Profiles

Tools

Authentication

Development

Compatibility

Support And Security

License