Needle MCP Server

สร้างเอเจนต์ด้วย Needle MCP Server

เซิร์ฟเวอร์ MCP (Model Context Protocol) สำหรับจัดการเอกสารและทำการค้นหาโดยใช้ Needle ผ่าน Claude's Desktop Application

สารบัญ

• ภาพรวม
• คุณสมบัติ
• การใช้งาน
  • คำสั่งใน Claude Desktop
  • ผลลัพธ์ใน Needle
• การติดตั้ง
• คำอธิบายวิดีโอ

---

ภาพรวม

Needle MCP Server ช่วยให้คุณสามารถ:

• จัดระเบียบและจัดเก็บเอกสารเพื่อการเรียกค้นที่รวดเร็ว
• ทำการค้นหาที่ทรงพลังผ่านโมเดลภาษาขนาดใหญ่ของ Claude
• ผสานรวมกับระบบนิเวศของ Needle ได้อย่างราบรื่นสำหรับการจัดการเอกสารขั้นสูง

MCP (Model Context Protocol) กำหนดมาตรฐานวิธีที่ LLM เชื่อมต่อกับแหล่งข้อมูลภายนอก คุณสามารถใช้ Needle MCP Server เพื่อเปิดใช้งานเครื่องมือค้นหาเชิงความหมายในแอปพลิเคชัน AI ของคุณได้อย่างง่ายดาย ทำให้ข้อมูลที่ฝังอยู่ใน PDF, DOCX, XLSX และไฟล์อื่นๆ สามารถเข้าถึงได้ทันทีโดย LLM

เราแนะนำให้ใช้เซิร์ฟเวอร์ MCP ระยะไกลของเรา เพื่อประสบการณ์ที่ดีที่สุด - ไม่จำเป็นต้องตั้งค่าในเครื่อง

---

คุณสมบัติ

• การจัดการเอกสาร: เพิ่มและจัดระเบียบเอกสารบนเซิร์ฟเวอร์ได้อย่างง่ายดาย
• การค้นหาและการเรียกค้น: การค้นหาด้วยภาษาธรรมชาติที่ใช้ Claude เพื่อคำตอบที่รวดเร็ว
• การผสานรวมที่ง่ายดาย: ทำงานร่วมกับ Claude Desktop และคอลเลกชันของ Needle

---

การใช้งาน

คำสั่งใน Claude Desktop

ด้านล่างนี้คือตัวอย่างวิธีการใช้คำสั่งใน Claude Desktop เพื่อโต้ตอบกับเซิร์ฟเวอร์:

1. เปิด Claude Desktop และเชื่อมต่อกับ Needle MCP Server
2. ใช้คำสั่งข้อความง่ายๆ เพื่อค้นหา เรียกค้น หรือแก้ไขเอกสาร
3. ตรวจสอบผลการค้นหา ที่ส่งกลับโดย Claude ในอินเทอร์เฟซที่ใช้งานง่าย

ผลลัพธ์ใน Needle

https://github.com/user-attachments/assets/0235e893-af96-4920-8364-1e86f73b3e6c

---

คำอธิบายวิดีโอ Youtube

สำหรับคำแนะนำแบบเต็มเกี่ยวกับการใช้ Needle MCP Server กับ Claude และ Claude Desktop ดู วิดีโอคำอธิบาย YouTube นี้

---

การติดตั้ง

1. เซิร์ฟเวอร์ MCP ระยะไกล (แนะนำ)

การกำหนดค่า Claude Desktop

สร้างหรืออัปเดตไฟล์กำหนดค่าของคุณ:

• สำหรับ MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• สำหรับ Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:Bearer ${NEEDLE_API_KEY}"
      ],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

การกำหนดค่า Cursor

สร้างหรืออัปเดต .cursor/mcp.json:

{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:${NEEDLE_AUTH_HEADER}"
      ],
      "env": {
        "NEEDLE_AUTH_HEADER": "Bearer <your-needle-api-key>"
      }
    }
  }
}

รับคีย์ API ของคุณจาก การตั้งค่า Needle

เรามีปลายทางสองแห่ง:

• Streamable HTTP: https://mcp.needle.app/mcp (แนะนำ)
• SSE: https://mcp.needle.app/sse

หมายเหตุ: MCP ได้ยกเลิกปลายทาง SSE ในข้อกำหนดล่าสุด ดังนั้นไคลเอนต์รุ่นใหม่ควรเลือกใช้ปลายทาง Streamable HTTP

2. การติดตั้งในเครื่อง

1. โคลนที่เก็บ:

git clone https://github.com/needle-ai/needle-mcp.git

2. ติดตั้ง UV ทั่วโลกโดยใช้ Homebrew:

brew install uv

3. สร้างไฟล์กำหนดค่าของคุณ:
   • สำหรับ MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • สำหรับ Windows: %APPDATA%/Claude/claude_desktop_config.json

การกำหนดค่า Claude Desktop

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

การกำหนดค่า Cursor

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

4. แทนที่ /path/to/needle-mcp ด้วยพาธที่เก็บจริงของคุณ
5. เพิ่มคีย์ API Needle ของคุณ
6. รีสตาร์ท Claude Desktop

การติดตั้งผ่าน Smithery

npx -y @smithery/cli install needle-mcp --client claude

3. การติดตั้ง Docker

1. โคลนและสร้าง:

git clone https://github.com/needle-ai/needle-mcp.git
cd needle-mcp
docker build -t needle-mcp .

2. เพิ่มลงในการกำหนดค่า Claude Desktop ของคุณ (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "needle": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

3. รีสตาร์ท Claude Desktop

ตัวอย่างการใช้งาน

• "สร้างคอลเลกชันใหม่ชื่อ 'Technical Docs'"
• "เพิ่มเอกสารนี้ลงในคอลเลกชัน ซึ่งคือ https://needle.app"
• "ค้นหาคอลเลกชันสำหรับข้อมูลเกี่ยวกับ AI"
• "แสดงรายการคอลเลกชันทั้งหมดของฉัน"

การแก้ไขปัญหา

หากไม่ทำงาน:

• ตรวจสอบให้แน่ใจว่า uv ติดตั้งทั่วโลกแล้ว (หากไม่ ให้ถอนการติดตั้งด้วย pip uninstall uv และติดตั้งใหม่ด้วย brew install uv)
• หรือค้นหาพาธ uv ด้วย which uv และแทนที่ "command": "uv" ด้วยพาธแบบเต็ม
• ตรวจสอบว่าคีย์ API Needle ของคุณถูกต้อง
• ตรวจสอบว่าพาธ needle-mcp ในการกำหนดค่าตรงกับตำแหน่งที่เก็บจริงของคุณ

รีเซ็ตการกำหนดค่า Claude Desktop

หากคุณเห็นการกำหนดค่าเก่าหรือการผสานรวมไม่ทำงาน:

1. ค้นหาไฟล์กำหนดค่า Claude Desktop ทั้งหมด:

find / -name "claude_desktop_config.json" 2>/dev/null

2. ลบข้อมูล Claude Desktop ทั้งหมด:

• บน MacOS: rm -rf ~/Library/Application\ Support/Claude/*
• บน Windows: ลบเนื้อหาของ %APPDATA%/Claude/

3. สร้างการกำหนดค่าใหม่ที่มีเฉพาะ Needle:

mkdir -p ~/Library/Application\ Support/Claude
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json
<< 'EOL'
{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
EOL

4. ออกจาก Claude Desktop โดยสมบูรณ์ (Command+Q บน Mac) และเปิดใหม่

5. หากคุณยังเห็นการกำหนดค่าเก่า:

• ตรวจสอบไฟล์กำหนดค่าเพิ่มเติมในตำแหน่งอื่น
• ลองล้างแคชเบราว์เซอร์หากใช้เวอร์ชันเว็บ
• ตรวจสอบว่าไฟล์กำหนดค่าถูกอ่านจากตำแหน่งที่ถูกต้อง