ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว

Minirag MCP

โดย sfrangulovรุ่น 1.1.1i★ 60iรันบนเครื่องหน้า repo ↗
ชื่อใน registryio.github.sfrangulov/minirag-mcp

วิธีติดตั้ง

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

Minirag MCP เป็นเซิร์ฟเวอร์ MCP ที่ทำงานบนเครื่องของคุณเอง ใช้ค้นหาแบบผสม (hybrid search) ในเอกสารที่อยู่ในโฟลเดอร์ที่คุณกำหนด

แปลอัตโนมัติจากคำอธิบายของผู้ทำ · ทีมยังไม่ได้ตรวจ

  • ต่อแบบ ติดตั้งในเครื่อง
  • บัญชีหรือคีย์ ต้องมี CHUNK_TOKEN_BUDGET
  • หมวด ค้นข้อมูลและความจำของ AI
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Local-first RAG MCP server: hybrid search over a folder of your own documents

ใช้คู่กับ

Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้

timesfm

TimesFM เป็นโมเดลพื้นฐานสำหรับข้อมูลอนุกรมเวลาที่ผ่านการฝึกมาแล้ว พัฒนาโดย Google Research ใช้สำหรับพยากรณ์ข้อมูลอนุกรมเวลา

โดย google-research★ 35,6291 skill

Skill · คู่มือ

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

โดย BigBodyCobain★ 11,6021 skill

Skill · คู่มือ

google-maps-scraper

google-maps-scraper ใช้ดึงข้อมูลสถานที่จาก Google Maps เช่น ชื่อ ที่อยู่ เบอร์โทร เว็บไซต์ คะแนนรีวิว จำนวนรีวิว พิกัดละติจูดลองจิจูด และอีเมล สำหรับแต่ละสถานที่

โดย gosom★ 8,2091 skill

Skill · คู่มือ

ทำไมอยู่อันดับนี้

หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้

ความนิยม21/80ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20
ความสด12/12ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม
ระบบยังตอบ0/8endpoint บนคลาวด์ตอบตอนตรวจล่าสุด
คะแนนการใช้งาน33/100

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 3/3 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)

ติดตั้ง

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

ให้ AI ติดตั้งให้ด้วยประโยคเดียว

ติดตั้ง Minirag MCP ให้หน่อย ทำตาม https://mcp.popnx.com/i/sfrangulov-minirag-mcp.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรัน

คัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน

ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ · ✓ ตรวจคำสั่งแล้ว 17 พ.ย. 2569

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Minirag MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ Claude AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ Minirag MCP ให้ Claude ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "minirag": { "command": "uvx", "args": [ "minirag-mcp" ], "env": { "CHUNK_TOKEN_BUDGET": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง CHUNK_TOKEN_BUDGET ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ Minirag MCP ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง uv ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    uv --version
    • ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้

    เปิดหน้าดาวน์โหลด uv ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: uv --version

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv

  2. สมัครและสร้างคีย์ของ Minirag MCP

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    เปิดเว็บของ Minirag MCP ↗

  3. เปิดไฟล์ตั้งค่าของแอป Claude บนคอม

    SettingsDeveloperEdit Config

  4. วางค่าตั้งนี้แล้วบันทึกไฟล์

    {
      "mcpServers": {
        "minirag": {
          "command": "uvx",
          "args": [
            "minirag-mcp"
          ],
          "env": {
            "CHUNK_TOKEN_BUDGET": "ใส่ค่าของคุณ"
          }
        }
      }
    }

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  5. ปิดแอป Claude แล้วเปิดใหม่

  6. ลองเลย

    ใช้ Minirag MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ Minirag MCP หรือมีชื่อเครื่องมือของ Minirag MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 12 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • BASE_DIR รูทเอกสารหนึ่งรายการ และเป็นขอบเขตความปลอดภัยสำหรับการเข้าถึงไฟล์ ค่าเริ่มต้นคือไดเรกทอรีทำงานของโปรเซส จะถูกละเว้นเมื่อกำหนด BASE_DIRS
    ดูต้นฉบับภาษาอังกฤษOne document root; also the security boundary for file access. Defaults to the process working directory. Ignored when BASE_DIRS is set.
  • BASE_DIRS อาร์เรย์ JSON ของรูทเอกสาร เช่น "/docs/a", "/docs/b" มีลำดับความสำคัญเหนือ BASE_DIR ค่าที่ไม่ถูกต้องถือเป็นข้อผิดพลาดการกำหนดค่าร้ายแรง
    ดูต้นฉบับภาษาอังกฤษJSON array of document roots, e.g. ["/docs/a", "/docs/b"]. Takes precedence over BASE_DIR. An invalid value is a hard configuration error.
  • DB_PATH ไดเรกทอรีดัชนี LanceDB ค่าเริ่มต้นคือ /.minirag/lancedb ทำให้แต่ละคลังข้อมูลมีดัชนีของตัวเอง
    ดูต้นฉบับภาษาอังกฤษLanceDB index directory. Defaults to /.minirag/lancedb, so each corpus gets its own index.
  • CACHE_DIR แคชโมเดลการฝังข้อมูล ค่าเริ่มต้นคือไดเรกทอรีแคชของผู้ใช้บนแพลตฟอร์ม ดังนั้นโมเดลขนาดประมาณ 220 MB จะถูกดาวน์โหลดเพียงครั้งเดียวและใช้ร่วมกัน
    ดูต้นฉบับภาษาอังกฤษEmbedding model cache. Defaults to the platform user cache dir, so the ~220 MB model is downloaded once and shared.
  • MODEL_NAME ID ของโมเดล fastembed การเปลี่ยนค่านี้ทำให้เวกเตอร์ที่มีอยู่ไม่เข้ากับคำค้นใหม่ ควรใช้คู่กับ DB_PATH ใหม่หรือการ ingest ใหม่ทั้งหมด
    ดูต้นฉบับภาษาอังกฤษfastembed model id. Changing it makes existing vectors incompatible with new queries; pair with a new DB_PATH or a full re-ingest.
    · ค่าเริ่มต้น sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
  • MAX_FILE_SIZE ขีดจำกัดขนาดต่อไฟล์เป็นไบต์ บังคับใช้ก่อนการแยกวิเคราะห์
    ดูต้นฉบับภาษาอังกฤษPer-file size limit in bytes, enforced before parsing.
    · ค่าเริ่มต้น 104857600
  • RAG_HYBRID_WEIGHT น้ำหนักของคำสำคัญในการรวมผลแบบ weighted RRF ช่วง 0.0-1.0 ค่า 0 หมายถึงใช้เฉพาะ vector ค่าที่สูงขึ้นจะเพิ่มส่วนร่วมของ BM25
    ดูต้นฉบับภาษาอังกฤษKeyword weight in the weighted RRF fusion, range 0.0-1.0. 0 is vector-only; higher values raise the BM25 contribution.
    · ค่าเริ่มต้น 0.6
  • RAG_GROUPING ตัวกรองการจัดกลุ่มผลลัพธ์ 'similar' เก็บเฉพาะกลุ่มที่ใกล้ที่สุด 'related' เก็บกลุ่มถัดไปด้วย หากไม่ตั้งค่า จะไม่มีตัวกรองการจัดกลุ่ม
    ดูต้นฉบับภาษาอังกฤษResult grouping filter. 'similar' keeps only the closest group; 'related' also keeps the next one. Unset means no grouping filter.
  • RAG_MAX_DISTANCE ทิ้งผลลัพธ์ที่ระยะห่างของเวกเตอร์เกินค่านี้ ค่าที่ต่ำลงหมายถึงเข้มงวดขึ้น หากไม่กำหนดค่า หมายถึงไม่มีการกรองตามระยะห่าง
    ดูต้นฉบับภาษาอังกฤษDrop results whose vector distance exceeds this value. Lower is stricter. Unset means no distance filter.
  • RAG_MAX_FILES เก็บชังก์จากไฟล์ที่มีคะแนนสูงสุดไม่เกินจำนวนนี้เท่านั้น หากไม่ตั้งค่า จะไม่มีการกรองต่อไฟล์
    ดูต้นฉบับภาษาอังกฤษKeep chunks from at most this many best-scoring files. Unset means no per-file filter.
  • RAG_INSTRUCTIONS_APPEND ย่อหน้าเพิ่มเติมที่ต่อท้ายคำแนะนำที่เซิร์ฟเวอร์ส่งให้ไคลเอนต์ตอนเชื่อมต่อ สำหรับแนวทางเฉพาะของคลังข้อมูล
    ดูต้นฉบับภาษาอังกฤษExtra paragraph appended to the instructions the server hands the client at connect time, for corpus-specific guidance.
  • ALLOW_PRIVATE_URLS ให้ ingest_url ดึงข้อมูลจากโฮสต์ที่resolve ไปยัง loopback, link-local, private, reserved หรือ unspecified ได้ ปิดเป็นค่าเริ่มต้น
    ดูต้นฉบับภาษาอังกฤษLet ingest_url fetch hosts resolving to loopback, link-local, private, reserved or unspecified addresses. Off by default.
    · ค่าเริ่มต้น false

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ChatGPT ยังต่อ Minirag MCP ไม่ได้

Minirag MCP ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ

คุณทำแบบนี้แทนได้

ก · ใช้แอปที่ต่อ Minirag MCP ได้

  • ต้องมีคีย์ของ Minirag MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
  • ต้องมีคีย์ของ Minirag MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
  • ต้องมีคีย์ของ Minirag MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
  • ต้องมีคีย์ของ Minirag MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ข · ตัวอื่นในหมวด ค้นข้อมูลและความจำของ AI ที่ต่อกับ ChatGPT ได้

เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์

ต่อกับ Claude Code ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Minirag MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ Claude Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ Minirag MCP ให้ Claude Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): claude mcp add --scope user minirag --env CHUNK_TOKEN_BUDGET='ใส่ค่าของคุณ' -- uvx minirag-mcp 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง CHUNK_TOKEN_BUDGET ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ Minirag MCP ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง uv ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    uv --version
    • ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้

    เปิดหน้าดาวน์โหลด uv ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: uv --version

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv

  2. สมัครและสร้างคีย์ของ Minirag MCP

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    เปิดเว็บของ Minirag MCP ↗

  3. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell

  4. วางคำสั่งนี้แล้วกด Enter

    claude mcp add --scope user minirag --env CHUNK_TOKEN_BUDGET='ใส่ค่าของคุณ' -- uvx minirag-mcp

    แก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  5. พิมพ์ /mcp ใน Claude Code

    ต้องเห็น Minirag MCP ในรายการและขึ้นว่าเชื่อมต่อแล้ว

  6. ลองเลย

    ใช้ Minirag MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude Code บอกว่ากำลังใช้ Minirag MCP หรือมีชื่อเครื่องมือของ Minirag MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 12 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • BASE_DIR รูทเอกสารหนึ่งรายการ และเป็นขอบเขตความปลอดภัยสำหรับการเข้าถึงไฟล์ ค่าเริ่มต้นคือไดเรกทอรีทำงานของโปรเซส จะถูกละเว้นเมื่อกำหนด BASE_DIRS
    ดูต้นฉบับภาษาอังกฤษOne document root; also the security boundary for file access. Defaults to the process working directory. Ignored when BASE_DIRS is set.
  • BASE_DIRS อาร์เรย์ JSON ของรูทเอกสาร เช่น "/docs/a", "/docs/b" มีลำดับความสำคัญเหนือ BASE_DIR ค่าที่ไม่ถูกต้องถือเป็นข้อผิดพลาดการกำหนดค่าร้ายแรง
    ดูต้นฉบับภาษาอังกฤษJSON array of document roots, e.g. ["/docs/a", "/docs/b"]. Takes precedence over BASE_DIR. An invalid value is a hard configuration error.
  • DB_PATH ไดเรกทอรีดัชนี LanceDB ค่าเริ่มต้นคือ /.minirag/lancedb ทำให้แต่ละคลังข้อมูลมีดัชนีของตัวเอง
    ดูต้นฉบับภาษาอังกฤษLanceDB index directory. Defaults to /.minirag/lancedb, so each corpus gets its own index.
  • CACHE_DIR แคชโมเดลการฝังข้อมูล ค่าเริ่มต้นคือไดเรกทอรีแคชของผู้ใช้บนแพลตฟอร์ม ดังนั้นโมเดลขนาดประมาณ 220 MB จะถูกดาวน์โหลดเพียงครั้งเดียวและใช้ร่วมกัน
    ดูต้นฉบับภาษาอังกฤษEmbedding model cache. Defaults to the platform user cache dir, so the ~220 MB model is downloaded once and shared.
  • MODEL_NAME ID ของโมเดล fastembed การเปลี่ยนค่านี้ทำให้เวกเตอร์ที่มีอยู่ไม่เข้ากับคำค้นใหม่ ควรใช้คู่กับ DB_PATH ใหม่หรือการ ingest ใหม่ทั้งหมด
    ดูต้นฉบับภาษาอังกฤษfastembed model id. Changing it makes existing vectors incompatible with new queries; pair with a new DB_PATH or a full re-ingest.
    · ค่าเริ่มต้น sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
  • MAX_FILE_SIZE ขีดจำกัดขนาดต่อไฟล์เป็นไบต์ บังคับใช้ก่อนการแยกวิเคราะห์
    ดูต้นฉบับภาษาอังกฤษPer-file size limit in bytes, enforced before parsing.
    · ค่าเริ่มต้น 104857600
  • RAG_HYBRID_WEIGHT น้ำหนักของคำสำคัญในการรวมผลแบบ weighted RRF ช่วง 0.0-1.0 ค่า 0 หมายถึงใช้เฉพาะ vector ค่าที่สูงขึ้นจะเพิ่มส่วนร่วมของ BM25
    ดูต้นฉบับภาษาอังกฤษKeyword weight in the weighted RRF fusion, range 0.0-1.0. 0 is vector-only; higher values raise the BM25 contribution.
    · ค่าเริ่มต้น 0.6
  • RAG_GROUPING ตัวกรองการจัดกลุ่มผลลัพธ์ 'similar' เก็บเฉพาะกลุ่มที่ใกล้ที่สุด 'related' เก็บกลุ่มถัดไปด้วย หากไม่ตั้งค่า จะไม่มีตัวกรองการจัดกลุ่ม
    ดูต้นฉบับภาษาอังกฤษResult grouping filter. 'similar' keeps only the closest group; 'related' also keeps the next one. Unset means no grouping filter.
  • RAG_MAX_DISTANCE ทิ้งผลลัพธ์ที่ระยะห่างของเวกเตอร์เกินค่านี้ ค่าที่ต่ำลงหมายถึงเข้มงวดขึ้น หากไม่กำหนดค่า หมายถึงไม่มีการกรองตามระยะห่าง
    ดูต้นฉบับภาษาอังกฤษDrop results whose vector distance exceeds this value. Lower is stricter. Unset means no distance filter.
  • RAG_MAX_FILES เก็บชังก์จากไฟล์ที่มีคะแนนสูงสุดไม่เกินจำนวนนี้เท่านั้น หากไม่ตั้งค่า จะไม่มีการกรองต่อไฟล์
    ดูต้นฉบับภาษาอังกฤษKeep chunks from at most this many best-scoring files. Unset means no per-file filter.
  • RAG_INSTRUCTIONS_APPEND ย่อหน้าเพิ่มเติมที่ต่อท้ายคำแนะนำที่เซิร์ฟเวอร์ส่งให้ไคลเอนต์ตอนเชื่อมต่อ สำหรับแนวทางเฉพาะของคลังข้อมูล
    ดูต้นฉบับภาษาอังกฤษExtra paragraph appended to the instructions the server hands the client at connect time, for corpus-specific guidance.
  • ALLOW_PRIVATE_URLS ให้ ingest_url ดึงข้อมูลจากโฮสต์ที่resolve ไปยัง loopback, link-local, private, reserved หรือ unspecified ได้ ปิดเป็นค่าเริ่มต้น
    ดูต้นฉบับภาษาอังกฤษLet ingest_url fetch hosts resolving to loopback, link-local, private, reserved or unspecified addresses. Off by default.
    · ค่าเริ่มต้น false

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Cursor ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Minirag MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ Cursor AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ Minirag MCP ให้ Cursor ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "minirag": { "command": "uvx", "args": [ "minirag-mcp" ], "env": { "CHUNK_TOKEN_BUDGET": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง CHUNK_TOKEN_BUDGET ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ Minirag MCP ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง uv ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    uv --version
    • ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้

    เปิดหน้าดาวน์โหลด uv ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: uv --version

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv

  2. สมัครและสร้างคีย์ของ Minirag MCP

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    เปิดเว็บของ Minirag MCP ↗

  3. กดปุ่มนี้เพื่อเปิด Cursor

    เปิดใน Cursor

    Cursor จะถามยืนยันการติดตั้ง ให้กด Install

  4. ใส่คีย์ในช่องที่ว่างไว้

    ในค่าตั้งของ Minirag MCP ช่อง CHUNK_TOKEN_BUDGET ยังว่าง ใส่คีย์ของคุณแล้วบันทึก

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  5. เปิดแชตของ AI ใน Cursor โหมด Agent

  6. ลองเลย

    ใช้ Minirag MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Cursor บอกว่ากำลังใช้ Minirag MCP หรือมีชื่อเครื่องมือของ Minirag MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 12 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • BASE_DIR รูทเอกสารหนึ่งรายการ และเป็นขอบเขตความปลอดภัยสำหรับการเข้าถึงไฟล์ ค่าเริ่มต้นคือไดเรกทอรีทำงานของโปรเซส จะถูกละเว้นเมื่อกำหนด BASE_DIRS
    ดูต้นฉบับภาษาอังกฤษOne document root; also the security boundary for file access. Defaults to the process working directory. Ignored when BASE_DIRS is set.
  • BASE_DIRS อาร์เรย์ JSON ของรูทเอกสาร เช่น "/docs/a", "/docs/b" มีลำดับความสำคัญเหนือ BASE_DIR ค่าที่ไม่ถูกต้องถือเป็นข้อผิดพลาดการกำหนดค่าร้ายแรง
    ดูต้นฉบับภาษาอังกฤษJSON array of document roots, e.g. ["/docs/a", "/docs/b"]. Takes precedence over BASE_DIR. An invalid value is a hard configuration error.
  • DB_PATH ไดเรกทอรีดัชนี LanceDB ค่าเริ่มต้นคือ /.minirag/lancedb ทำให้แต่ละคลังข้อมูลมีดัชนีของตัวเอง
    ดูต้นฉบับภาษาอังกฤษLanceDB index directory. Defaults to /.minirag/lancedb, so each corpus gets its own index.
  • CACHE_DIR แคชโมเดลการฝังข้อมูล ค่าเริ่มต้นคือไดเรกทอรีแคชของผู้ใช้บนแพลตฟอร์ม ดังนั้นโมเดลขนาดประมาณ 220 MB จะถูกดาวน์โหลดเพียงครั้งเดียวและใช้ร่วมกัน
    ดูต้นฉบับภาษาอังกฤษEmbedding model cache. Defaults to the platform user cache dir, so the ~220 MB model is downloaded once and shared.
  • MODEL_NAME ID ของโมเดล fastembed การเปลี่ยนค่านี้ทำให้เวกเตอร์ที่มีอยู่ไม่เข้ากับคำค้นใหม่ ควรใช้คู่กับ DB_PATH ใหม่หรือการ ingest ใหม่ทั้งหมด
    ดูต้นฉบับภาษาอังกฤษfastembed model id. Changing it makes existing vectors incompatible with new queries; pair with a new DB_PATH or a full re-ingest.
    · ค่าเริ่มต้น sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
  • MAX_FILE_SIZE ขีดจำกัดขนาดต่อไฟล์เป็นไบต์ บังคับใช้ก่อนการแยกวิเคราะห์
    ดูต้นฉบับภาษาอังกฤษPer-file size limit in bytes, enforced before parsing.
    · ค่าเริ่มต้น 104857600
  • RAG_HYBRID_WEIGHT น้ำหนักของคำสำคัญในการรวมผลแบบ weighted RRF ช่วง 0.0-1.0 ค่า 0 หมายถึงใช้เฉพาะ vector ค่าที่สูงขึ้นจะเพิ่มส่วนร่วมของ BM25
    ดูต้นฉบับภาษาอังกฤษKeyword weight in the weighted RRF fusion, range 0.0-1.0. 0 is vector-only; higher values raise the BM25 contribution.
    · ค่าเริ่มต้น 0.6
  • RAG_GROUPING ตัวกรองการจัดกลุ่มผลลัพธ์ 'similar' เก็บเฉพาะกลุ่มที่ใกล้ที่สุด 'related' เก็บกลุ่มถัดไปด้วย หากไม่ตั้งค่า จะไม่มีตัวกรองการจัดกลุ่ม
    ดูต้นฉบับภาษาอังกฤษResult grouping filter. 'similar' keeps only the closest group; 'related' also keeps the next one. Unset means no grouping filter.
  • RAG_MAX_DISTANCE ทิ้งผลลัพธ์ที่ระยะห่างของเวกเตอร์เกินค่านี้ ค่าที่ต่ำลงหมายถึงเข้มงวดขึ้น หากไม่กำหนดค่า หมายถึงไม่มีการกรองตามระยะห่าง
    ดูต้นฉบับภาษาอังกฤษDrop results whose vector distance exceeds this value. Lower is stricter. Unset means no distance filter.
  • RAG_MAX_FILES เก็บชังก์จากไฟล์ที่มีคะแนนสูงสุดไม่เกินจำนวนนี้เท่านั้น หากไม่ตั้งค่า จะไม่มีการกรองต่อไฟล์
    ดูต้นฉบับภาษาอังกฤษKeep chunks from at most this many best-scoring files. Unset means no per-file filter.
  • RAG_INSTRUCTIONS_APPEND ย่อหน้าเพิ่มเติมที่ต่อท้ายคำแนะนำที่เซิร์ฟเวอร์ส่งให้ไคลเอนต์ตอนเชื่อมต่อ สำหรับแนวทางเฉพาะของคลังข้อมูล
    ดูต้นฉบับภาษาอังกฤษExtra paragraph appended to the instructions the server hands the client at connect time, for corpus-specific guidance.
  • ALLOW_PRIVATE_URLS ให้ ingest_url ดึงข้อมูลจากโฮสต์ที่resolve ไปยัง loopback, link-local, private, reserved หรือ unspecified ได้ ปิดเป็นค่าเริ่มต้น
    ดูต้นฉบับภาษาอังกฤษLet ingest_url fetch hosts resolving to loopback, link-local, private, reserved or unspecified addresses. Off by default.
    · ค่าเริ่มต้น false

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Minirag MCP (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ VS Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ Minirag MCP ให้ VS Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "servers": { "minirag": { "type": "stdio", "command": "uvx", "args": [ "minirag-mcp" ], "env": { "CHUNK_TOKEN_BUDGET": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง CHUNK_TOKEN_BUDGET ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ Minirag MCP ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง uv ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    uv --version
    • ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้

    เปิดหน้าดาวน์โหลด uv ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: uv --version

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv

  2. สมัครและสร้างคีย์ของ Minirag MCP

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    เปิดเว็บของ Minirag MCP ↗

  3. กดปุ่มนี้เพื่อเปิด VS Code

    เปิดใน VS Code

    VS Code จะถามยืนยันการติดตั้ง ให้กด Install

  4. ใส่คีย์ในช่องที่ว่างไว้

    ในค่าตั้งของ Minirag MCP ช่อง CHUNK_TOKEN_BUDGET ยังว่าง ใส่คีย์ของคุณแล้วบันทึก

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  5. เปิดแชตของ AI ใน VS Code โหมด Agent

  6. ลองเลย

    ใช้ Minirag MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า VS Code บอกว่ากำลังใช้ Minirag MCP หรือมีชื่อเครื่องมือของ Minirag MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 12 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • BASE_DIR รูทเอกสารหนึ่งรายการ และเป็นขอบเขตความปลอดภัยสำหรับการเข้าถึงไฟล์ ค่าเริ่มต้นคือไดเรกทอรีทำงานของโปรเซส จะถูกละเว้นเมื่อกำหนด BASE_DIRS
    ดูต้นฉบับภาษาอังกฤษOne document root; also the security boundary for file access. Defaults to the process working directory. Ignored when BASE_DIRS is set.
  • BASE_DIRS อาร์เรย์ JSON ของรูทเอกสาร เช่น "/docs/a", "/docs/b" มีลำดับความสำคัญเหนือ BASE_DIR ค่าที่ไม่ถูกต้องถือเป็นข้อผิดพลาดการกำหนดค่าร้ายแรง
    ดูต้นฉบับภาษาอังกฤษJSON array of document roots, e.g. ["/docs/a", "/docs/b"]. Takes precedence over BASE_DIR. An invalid value is a hard configuration error.
  • DB_PATH ไดเรกทอรีดัชนี LanceDB ค่าเริ่มต้นคือ /.minirag/lancedb ทำให้แต่ละคลังข้อมูลมีดัชนีของตัวเอง
    ดูต้นฉบับภาษาอังกฤษLanceDB index directory. Defaults to /.minirag/lancedb, so each corpus gets its own index.
  • CACHE_DIR แคชโมเดลการฝังข้อมูล ค่าเริ่มต้นคือไดเรกทอรีแคชของผู้ใช้บนแพลตฟอร์ม ดังนั้นโมเดลขนาดประมาณ 220 MB จะถูกดาวน์โหลดเพียงครั้งเดียวและใช้ร่วมกัน
    ดูต้นฉบับภาษาอังกฤษEmbedding model cache. Defaults to the platform user cache dir, so the ~220 MB model is downloaded once and shared.
  • MODEL_NAME ID ของโมเดล fastembed การเปลี่ยนค่านี้ทำให้เวกเตอร์ที่มีอยู่ไม่เข้ากับคำค้นใหม่ ควรใช้คู่กับ DB_PATH ใหม่หรือการ ingest ใหม่ทั้งหมด
    ดูต้นฉบับภาษาอังกฤษfastembed model id. Changing it makes existing vectors incompatible with new queries; pair with a new DB_PATH or a full re-ingest.
    · ค่าเริ่มต้น sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
  • MAX_FILE_SIZE ขีดจำกัดขนาดต่อไฟล์เป็นไบต์ บังคับใช้ก่อนการแยกวิเคราะห์
    ดูต้นฉบับภาษาอังกฤษPer-file size limit in bytes, enforced before parsing.
    · ค่าเริ่มต้น 104857600
  • RAG_HYBRID_WEIGHT น้ำหนักของคำสำคัญในการรวมผลแบบ weighted RRF ช่วง 0.0-1.0 ค่า 0 หมายถึงใช้เฉพาะ vector ค่าที่สูงขึ้นจะเพิ่มส่วนร่วมของ BM25
    ดูต้นฉบับภาษาอังกฤษKeyword weight in the weighted RRF fusion, range 0.0-1.0. 0 is vector-only; higher values raise the BM25 contribution.
    · ค่าเริ่มต้น 0.6
  • RAG_GROUPING ตัวกรองการจัดกลุ่มผลลัพธ์ 'similar' เก็บเฉพาะกลุ่มที่ใกล้ที่สุด 'related' เก็บกลุ่มถัดไปด้วย หากไม่ตั้งค่า จะไม่มีตัวกรองการจัดกลุ่ม
    ดูต้นฉบับภาษาอังกฤษResult grouping filter. 'similar' keeps only the closest group; 'related' also keeps the next one. Unset means no grouping filter.
  • RAG_MAX_DISTANCE ทิ้งผลลัพธ์ที่ระยะห่างของเวกเตอร์เกินค่านี้ ค่าที่ต่ำลงหมายถึงเข้มงวดขึ้น หากไม่กำหนดค่า หมายถึงไม่มีการกรองตามระยะห่าง
    ดูต้นฉบับภาษาอังกฤษDrop results whose vector distance exceeds this value. Lower is stricter. Unset means no distance filter.
  • RAG_MAX_FILES เก็บชังก์จากไฟล์ที่มีคะแนนสูงสุดไม่เกินจำนวนนี้เท่านั้น หากไม่ตั้งค่า จะไม่มีการกรองต่อไฟล์
    ดูต้นฉบับภาษาอังกฤษKeep chunks from at most this many best-scoring files. Unset means no per-file filter.
  • RAG_INSTRUCTIONS_APPEND ย่อหน้าเพิ่มเติมที่ต่อท้ายคำแนะนำที่เซิร์ฟเวอร์ส่งให้ไคลเอนต์ตอนเชื่อมต่อ สำหรับแนวทางเฉพาะของคลังข้อมูล
    ดูต้นฉบับภาษาอังกฤษExtra paragraph appended to the instructions the server hands the client at connect time, for corpus-specific guidance.
  • ALLOW_PRIVATE_URLS ให้ ingest_url ดึงข้อมูลจากโฮสต์ที่resolve ไปยัง loopback, link-local, private, reserved หรือ unspecified ได้ ปิดเป็นค่าเริ่มต้น
    ดูต้นฉบับภาษาอังกฤษLet ingest_url fetch hosts resolving to loopback, link-local, private, reserved or unspecified addresses. Off by default.
    · ค่าเริ่มต้น false

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Minirag MCP อยู่💬 พูดคุย →
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ติดตั้งในเครื่อง

Claude Code

claude mcp add --scope user minirag --env CHUNK_TOKEN_BUDGET='ใส่ค่าของคุณ' -- uvx minirag-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "minirag": {
      "command": "uvx",
      "args": [
        "minirag-mcp"
      ],
      "env": {
        "CHUNK_TOKEN_BUDGET": "ใส่ค่าของคุณ"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "minirag": {
      "command": "uvx",
      "args": [
        "minirag-mcp"
      ],
      "env": {
        "CHUNK_TOKEN_BUDGET": "ใส่ค่าของคุณ"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "minirag": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "minirag-mcp"
      ],
      "env": {
        "CHUNK_TOKEN_BUDGET": "ใส่ค่าของคุณ"
      }
    }
  }
}

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

  • BASE_DIR env
    รูทเอกสารหนึ่งรายการ และเป็นขอบเขตความปลอดภัยสำหรับการเข้าถึงไฟล์ ค่าเริ่มต้นคือไดเรกทอรีทำงานของโปรเซส จะถูกละเว้นเมื่อกำหนด BASE_DIRS
    ดูต้นฉบับภาษาอังกฤษOne document root; also the security boundary for file access. Defaults to the process working directory. Ignored when BASE_DIRS is set.
  • BASE_DIRS env
    อาร์เรย์ JSON ของรูทเอกสาร เช่น "/docs/a", "/docs/b" มีลำดับความสำคัญเหนือ BASE_DIR ค่าที่ไม่ถูกต้องถือเป็นข้อผิดพลาดการกำหนดค่าร้ายแรง
    ดูต้นฉบับภาษาอังกฤษJSON array of document roots, e.g. ["/docs/a", "/docs/b"]. Takes precedence over BASE_DIR. An invalid value is a hard configuration error.
  • DB_PATH env
    ไดเรกทอรีดัชนี LanceDB ค่าเริ่มต้นคือ /.minirag/lancedb ทำให้แต่ละคลังข้อมูลมีดัชนีของตัวเอง
    ดูต้นฉบับภาษาอังกฤษLanceDB index directory. Defaults to /.minirag/lancedb, so each corpus gets its own index.
  • CACHE_DIR env
    แคชโมเดลการฝังข้อมูล ค่าเริ่มต้นคือไดเรกทอรีแคชของผู้ใช้บนแพลตฟอร์ม ดังนั้นโมเดลขนาดประมาณ 220 MB จะถูกดาวน์โหลดเพียงครั้งเดียวและใช้ร่วมกัน
    ดูต้นฉบับภาษาอังกฤษEmbedding model cache. Defaults to the platform user cache dir, so the ~220 MB model is downloaded once and shared.
  • MODEL_NAME env
    ID ของโมเดล fastembed การเปลี่ยนค่านี้ทำให้เวกเตอร์ที่มีอยู่ไม่เข้ากับคำค้นใหม่ ควรใช้คู่กับ DB_PATH ใหม่หรือการ ingest ใหม่ทั้งหมด
    ดูต้นฉบับภาษาอังกฤษfastembed model id. Changing it makes existing vectors incompatible with new queries; pair with a new DB_PATH or a full re-ingest.
  • MAX_FILE_SIZE env
    ขีดจำกัดขนาดต่อไฟล์เป็นไบต์ บังคับใช้ก่อนการแยกวิเคราะห์
    ดูต้นฉบับภาษาอังกฤษPer-file size limit in bytes, enforced before parsing.
  • CHUNK_TOKEN_BUDGET ความลับ จำเป็น env
    ขนาดหน่วยการค้นคืนในหน่วยโทเค็นของโมเดลการฝังเอง ช่วง 16-128; ขีดจำกัดสูงสุดคือความยาวลำดับที่โมเดลถูกฝึกมา
    ดูต้นฉบับภาษาอังกฤษRetrieval-unit size in the embedding model's own tokens. Range 16-128; the ceiling is the model's trained sequence length.
  • RAG_HYBRID_WEIGHT env
    น้ำหนักของคำสำคัญในการรวมผลแบบ weighted RRF ช่วง 0.0-1.0 ค่า 0 หมายถึงใช้เฉพาะ vector ค่าที่สูงขึ้นจะเพิ่มส่วนร่วมของ BM25
    ดูต้นฉบับภาษาอังกฤษKeyword weight in the weighted RRF fusion, range 0.0-1.0. 0 is vector-only; higher values raise the BM25 contribution.
  • RAG_GROUPING env
    ตัวกรองการจัดกลุ่มผลลัพธ์ 'similar' เก็บเฉพาะกลุ่มที่ใกล้ที่สุด 'related' เก็บกลุ่มถัดไปด้วย หากไม่ตั้งค่า จะไม่มีตัวกรองการจัดกลุ่ม
    ดูต้นฉบับภาษาอังกฤษResult grouping filter. 'similar' keeps only the closest group; 'related' also keeps the next one. Unset means no grouping filter.
  • RAG_MAX_DISTANCE env
    ทิ้งผลลัพธ์ที่ระยะห่างของเวกเตอร์เกินค่านี้ ค่าที่ต่ำลงหมายถึงเข้มงวดขึ้น หากไม่กำหนดค่า หมายถึงไม่มีการกรองตามระยะห่าง
    ดูต้นฉบับภาษาอังกฤษDrop results whose vector distance exceeds this value. Lower is stricter. Unset means no distance filter.
  • RAG_MAX_FILES env
    เก็บชังก์จากไฟล์ที่มีคะแนนสูงสุดไม่เกินจำนวนนี้เท่านั้น หากไม่ตั้งค่า จะไม่มีการกรองต่อไฟล์
    ดูต้นฉบับภาษาอังกฤษKeep chunks from at most this many best-scoring files. Unset means no per-file filter.
  • RAG_INSTRUCTIONS_APPEND env
    ย่อหน้าเพิ่มเติมที่ต่อท้ายคำแนะนำที่เซิร์ฟเวอร์ส่งให้ไคลเอนต์ตอนเชื่อมต่อ สำหรับแนวทางเฉพาะของคลังข้อมูล
    ดูต้นฉบับภาษาอังกฤษExtra paragraph appended to the instructions the server hands the client at connect time, for corpus-specific guidance.
  • ALLOW_PRIVATE_URLS env
    ให้ ingest_url ดึงข้อมูลจากโฮสต์ที่resolve ไปยัง loopback, link-local, private, reserved หรือ unspecified ได้ ปิดเป็นค่าเริ่มต้น
    ดูต้นฉบับภาษาอังกฤษLet ingest_url fetch hosts resolving to loopback, link-local, private, reserved or unspecified addresses. Off by default.

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

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

สรุป

ดาวน์โหลดต่อสัปดาห์i
111/สัปดาห์
การเชื่อมต่อ
รันบนเครื่อง
รุ่นล่าสุดi
1.1.1
ส่งเข้า registryi
17 พ.ย. 2569
แก้โค้ดล่าสุดi
17 พ.ย. 2569
ผู้ทำ
sfrangulov
แพ็กเกจ
pypi: minirag-mcp
เว็บผู้ทำ
github.com
สถานะใน registry
ใช้งานอยู่

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

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ติดตั้งบนเครื่องได้ใน

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

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

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

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

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

  • ✓ ผ่าน

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

    ชื่อใน registry ยืนยันด้วยบัญชี GitHub sfrangulov ซึ่งเป็นเจ้าของ repo

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด เมื่อวานซืน

  • ✓ ผ่าน

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

    ใช้ MIT

  • – ไม่เกี่ยว

    endpoint ตอบ

    ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต

  • – ไม่เกี่ยว

    ล็อกอินแบบ OAuth

    ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน

  • … ยังไม่ตรวจ

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

    รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)

ยังไม่ได้ตรวจ

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/sfrangulov-minirag-mcp.svg?lang=th)](https://mcp.popnx.com/th/servers/sfrangulov-minirag-mcp)

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบเพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด ค้นข้อมูลและความจำของ AIi

  • ดาวมากกว่า 97% ของอีก 6384 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 95% ของอีก 6384 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 6384 ตัวในหมวดนี้

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

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

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

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

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

ต้องใส่ค่าเหล่านี้: CHUNK_TOKEN_BUDGET

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

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

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

repo บน GitHub มีการแก้โค้ดล่าสุด เมื่อวานซืน และส่งรุ่นล่าสุด (1.1.1) เข้า registry เมื่อวานซืน

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

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

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

ในหมวดเดียวกันมี OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

ตัวอื่นที่ทำงานคล้ายกัน

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

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

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

โดย every-appใช้กันมาก★ 28.2Kอัปเดต 5 วันที่ผ่านมา

รันบนคลาวด์✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

โดย exa-labsใช้กันมาก★ 5.2Kอัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · exa.aiทีม PopNx ลองใช้จริงแล้ว

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

โดย MicrosoftDocsใช้กันมาก★ 2Kอัปเดต 12 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · microsoft.comทีม PopNx ลองใช้จริงแล้ว

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

โดย proxysoulกำลังโต★ 1.6Kอัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ empryo.com

COTAL actions (cotal.ai)

cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls

โดย Cotal-AIกำลังโต★ 399อัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · cotal.ai
เทียบกับตัวที่คล้ายกัน
ตัวนี้
Minirag MCP
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
ทำงานที่ไหนต้องลงในเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่อง
ต้องใส่คีย์ใช่ไม่ไม่ไม่ไม่ไม่
กด + ใน Claude ได้ไม่ใช่ใช่ใช่ไม่ไม่
ผลตรวจเบื้องต้น3/35/52/44/44/44/4
สัญญาอนุญาตMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
ราคาไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียน

README จากผู้ทำ

เปิดอ่าน README

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

minirag-mcp

A local-first RAG (retrieval-augmented generation) MCP server. Point it at a folder of documents and it gives your MCP client (Claude Code, Cursor, Codex, ...) hybrid search — semantic vector similarity plus a keyword boost for exact terms — over that content.

Nothing leaves your machine except two things: the one-time embedding-model download on first use, and the explicit ingest_url call when you ask it to fetch a web page. Ingesting local files, indexing, and querying never touch the network.

It is a Python, MCP-native analog of shinpr/mcp-local-rag (TypeScript), built on fastmcp, fastembed, and LanceDB.

Features

  • Hybrid search — vector similarity (fastembed/ONNX) fused with keyword ranking (LanceDB BM25 full-text search) by weighted Reciprocal Rank Fusion, so exact identifiers and error codes surface alongside semantically similar passages.
  • Every mention, counted — find_mentions lists every document that contains a word or phrase, not the top few, and says how many documents it searched, so "list all", "how many" and "it is not there" get a complete answer. See Finding every mention.
  • Look-alike documents named — a result whose document shares most of its text with other indexed documents, such as another version of it or a sibling from the same template, names them and how much text they share. See Look-alike documents.
  • Filenames are searchable — keyword search covers document titles as well as body text, and an informative filename becomes the document's title when the document's own heading is boilerplate. In many real document sets the filename is the only place the document code and subject appear at all. See Titles and filenames.
  • Multilingual by default — the default embedding model covers 50+ languages, so English and Russian corpora both work out of the box.
  • Converted once, not re-read every chat — a PDF handed to an assistant is read again, page by page, in every new conversation, and scanned pages cost the most. Here each document is converted (and OCRed) once at ingest, and a question brings back only the sections that answer it, so it costs those sections rather than the whole file.
  • Chunks sized in tokens, passages returned whole — what gets ranked is a small unit that fits the embedding model's 128-token ceiling; what comes back is the section around it — a transcript time window, a heading section, a slide, a table. See Chunking.
  • 12 file formats ingested via markitdown (PDF, DOCX, PPTX, XLSX, HTML, CSV, EPUB, Jupyter notebooks, Markdown, and plain text), plus direct text/markdown/HTML ingestion and URL fetching.
  • Scans, with the optional `[ocr]` extra — image-only PDFs are recognized page by page and standalone images become documents, locally, on the CPU. See OCR for scanned documents.
  • Document labels, with the optional `[classify]` extra — filter by kind of document, project and date, labelled locally. See Document labels (optional).
  • Searches without being asked — the server ships a routing policy that clients put in front of the model, so a question your documents can answer goes to the index instead of to the model's memory. See Search by Default.
  • MCP server and CLI over the same index — inspect and manage the index from a terminal without going through an MCP client.
  • Degrades gracefully — a broken configuration doesn't crash the server; every tool reports the error and status always answers.
  • No hidden network calls — see Security and Operation.

Quick Start

Every client below launches the same process; only the config format differs. Replace /absolute/path/to/docs with the folder you want indexed.

The invocation is uvx minirag-mcp. It resolves and caches the package on first run, so start-up is slow once and fast afterwards.

uvx resolves that name from PyPI, so the snippets below work from release 0.1.0 onward; on an earlier revision use From an unreleased revision instead. That distinction is worth checking before you paste: claude mcp add writes the entry without ever running the command, so an unresolvable package looks like a successful setup and only fails later, silently, when the client tries to launch the server.

Claude Code
claude mcp add minirag --scope user --env BASE_DIR=/absolute/path/to/docs \

-- uvx minirag-mcp

Claude Desktop (one-click)

A Claude Desktop extension, minirag-mcp.mcpb, installs without uv, a terminal or a JSON file: open it (double-click, or Settings > Extensions > Advanced settings > Install Extension…), pick the Documents folder, then ask Claude to "sync minirag". It is not published yet; build it from a clone (npx, so Node.js, runs the official packer):

uv run python mcpb/build.py                         # writes dist/minirag-mcp.mcpb

uv run python mcpb/smoke.py dist/minirag-mcp.mcpb # install and start it as Desktop does

  • Runs on Apple Silicon Macs with macOS 14 or later and on 64-bit Intel/AMD Windows. Intel Macs and Windows on ARM cannot install it: lancedb publishes no package for them.
  • Installing downloads the Python dependencies, about 650 MB on disk. The index lives in a hidden .minirag folder inside the documents folder. The [ocr] and [classify] extras are not included.
  • The file is unsigned: Desktop warns before installing it, and an organization that requires signed extensions refuses it.

Verified: the official mcpb CLI validates and packs it, and mcpb/smoke.py passes on an Apple Silicon Mac and, in CI (.github/workflows/bundle.yml), on GitHub's macOS (Apple Silicon) and Windows x64 runners. That script repeats outside the app what Claude Desktop 3.6556 does with such a file — unpack it into a folder whose path has a space, run uv sync --quiet there, start the server with the manifest's arguments, the picked folder and only the environment variables Desktop passes on — and checks initialize, the tool list and status; --search also indexes and finds a document (run on the Mac only). It uses uv 0.9.7, which Desktop downloads when a machine has no uv. Not verified: installing through the Desktop app itself, on macOS or Windows — the install dialog, the folder picker, the extension appearing under Connectors. The first start after installing took 4–9 seconds on the CI runners but about 50 on the development Mac, loading native libraries for the first time (later starts: about 2); whether Desktop waits that long is untested. If the extension shows as failed right after installing, turn it off and on in Settings > Extensions.

Claude Desktop

Edit the config file — create it if it does not exist:

macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json
{

"mcpServers": { "minirag": { "command": "/absolute/path/to/uvx", "args": ["minirag-mcp"], "env": { "BASE_DIR": "/absolute/path/to/docs" } } } }

Then quit Claude Desktop completely (Cmd+Q on macOS, not just closing the window) and reopen it. The config is read at launch; closing the window leaves the old process running with the old config.

Two things that catch people out:

Give `command` an absolute path. Desktop apps do not inherit your shell's PATH. uvx usually lives in ~/.local/bin, which is not on the PATH a GUI-launched process sees, so a bare "uvx" fails with nothing useful in the UI. Run which uvx and paste the result. The other snippets on this page can use a bare uvx because a terminal-launched client has your PATH.

Merge, do not replace. If the file already exists it holds your other servers and preferences under the same top-level object — add minirag inside the existing mcpServers, and leave everything else alone. Back the file up first; a malformed JSON file makes Desktop start with no servers at all and says little about why.

To check the config before restarting, run the same command by hand — it should print your configuration and exit:

BASE_DIR=/absolute/path/to/docs /absolute/path/to/uvx minirag-mcp status
Cursor (~/.cursor/mcp.json)
{

"mcpServers": { "minirag": { "command": "uvx", "args": ["minirag-mcp"], "env": { "BASE_DIR": "/absolute/path/to/docs" } } } }

Codex (~/.codex/config.toml)
[mcp_servers.minirag]

command = "uvx" args = ["minirag-mcp"]

[mcp_servers.minirag.env] BASE_DIR = "/absolute/path/to/docs"

From an unreleased revision

To run a revision that hasn't been released to PyPI — an unreleased fix, or one specific commit — install from this repository instead. In any snippet above, replace uvx minirag-mcp with:

uvx --from git+https://github.com/sfrangulov/minirag-mcp minirag-mcp

As an argument list, that is ["--from", "git+https://github.com/sfrangulov/minirag-mcp", "minirag-mcp"]. Append @ to the URL to pin a revision.

From a clone

For development, or to run the CLI against a working tree you can edit:

git clone https://github.com/sfrangulov/minirag-mcp

cd minirag-mcp uv sync uv run minirag-mcp status --base-dir /absolute/path/to/docs

First use

The index starts empty — nothing is scanned until you ask for it:

  1. Ask your client to sync: "sync minirag" (calls sync_start, then poll sync_status until it reports succeeded). From a terminal you can do the same thing synchronously: minirag-mcp sync --base-dir /absolute/path/to/docs.
  2. Then query: "search minirag for ..." (calls query_documents).

The first sync (or the first ingest of any kind) downloads the embedding model — see Requirements.

Requirements

  • Python 3.11+
  • uv (provides uvx)
  • ~220 MB of disk space and a network connection the first time a document is ingested — fastembed downloads the quantized ONNX weights for the default model and caches them; every ingestion after that is fully offline.

Supported Content

Files under the document root(s) with one of these 13 extensions are picked up by sync_start/sync and ingest_file/ingest and converted to Markdown, all but .vtt by markitdown:

.md .markdown .txt .pdf .docx .pptx .xlsx .html .htm .csv .epub .ipynb .vtt

A .vtt is a WebVTT transcript, the format Teams and Zoom export a call in. Each turn becomes a **Speaker** MM:SS line followed by what was said, with the segments Teams cuts one utterance into joined back together, so a call is chunked as a transcript. It is read by a parser of its own: markitdown has no WebVTT converter and would index the raw cue ids and timings as plain text. A .vtt that cannot be parsed, or whose encoding cannot be told (save it as UTF-8), fails instead.

A scan skips dot-prefixed names and the ~$…

ตัดมาแค่ช่วงต้น อ่านต่อใน repo