Needle

resmi

RAG siap produksi langsung untuk mencari dan mengambil data dari dokumen Anda sendiri.

GitHub

Apa yang bisa Anda lakukan dengan Needle MCP?

Create a new collection — Ask Claude to create a document collection in Needle, e.g. “Create a new collection called ‘Technical Docs’”.
Add documents to a collection — Provide a URL or file and have Claude add it to a specified Needle collection.
Search across your documents — Use natural language to search a collection for specific information buried in PDFs, DOCX, or XLSX files.
List all collections — Ask Claude to retrieve a list of your existing Needle collections.

Dokumentasi

Membangun Agen dengan Needle MCP Server

Screenshot of Feature - Claude

Server MCP (Model Context Protocol) untuk mengelola dokumen dan melakukan pencarian menggunakan Needle melalui Aplikasi Desktop Claude.

Daftar Isi

Ikhtisar
Fitur
Penggunaan
- Perintah di Claude Desktop
- Hasil di Needle
Instalasi
Penjelasan Video

Ikhtisar

Needle MCP Server memungkinkan Anda untuk:

Mengatur dan menyimpan dokumen untuk pengambilan cepat.
Melakukan pencarian canggih melalui model bahasa besar Claude.
Terintegrasi dengan mulus ke dalam ekosistem Needle untuk manajemen dokumen tingkat lanjut.

MCP (Model Context Protocol) menstandarisasi cara LLM terhubung ke sumber data eksternal. Anda dapat menggunakan Needle MCP Server untuk dengan mudah mengaktifkan alat pencarian semantik di aplikasi AI Anda, membuat data yang terkubur dalam PDF, DOCX, XLSX, dan file lainnya dapat diakses secara instan oleh LLM.

Kami merekomendasikan menggunakan server MCP jarak jauh kami untuk pengalaman terbaik - tidak perlu pengaturan lokal.

Fitur

Manajemen Dokumen: Menambah dan mengatur dokumen di server dengan mudah.
Pencarian & Pengambilan: Pencarian bahasa alami berbasis Claude untuk jawaban cepat.
Integrasi Mudah: Bekerja dengan Claude Desktop dan koleksi Needle.

Penggunaan

Perintah di Claude Desktop

Berikut adalah contoh bagaimana perintah dapat digunakan di Claude Desktop untuk berinteraksi dengan server:

Using commands in Claude Desktop

Buka Claude Desktop dan hubungkan ke Needle MCP Server.
Gunakan perintah teks sederhana untuk mencari, mengambil, atau memodifikasi dokumen.
Tinjau hasil pencarian yang dikembalikan oleh Claude dalam antarmuka yang ramah pengguna.

Hasil di Needle

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

Penjelasan Video Youtube

Untuk panduan lengkap tentang penggunaan Needle MCP Server dengan Claude dan Claude Desktop, tonton video penjelasan YouTube ini.

Instalasi

1. Server MCP Jarak Jauh (Direkomendasikan)

Konfigurasi Claude Desktop

Buat atau perbarui file konfigurasi Anda:

Untuk MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Untuk 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>"
      }
    }
  }
}

Konfigurasi Cursor

Buat atau perbarui .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>"
      }
    }
  }
}

Dapatkan kunci API Anda dari Pengaturan Needle.

Kami menyediakan dua endpoint:

HTTP Streamable: https://mcp.needle.app/mcp (direkomendasikan)
SSE: https://mcp.needle.app/sse

Catatan: MCP menghentikan endpoint SSE dalam spesifikasi terbaru, jadi klien yang lebih baru sebaiknya menggunakan endpoint HTTP Streamable.

2. Instalasi Lokal

Kloning repositori:

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

Instal UV secara global menggunakan Homebrew:

brew install uv

Buat file konfigurasi Anda:
- Untuk MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Untuk Windows: %APPDATA%/Claude/claude_desktop_config.json

Konfigurasi Claude Desktop

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

Konfigurasi Cursor

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

Ganti /path/to/needle-mcp dengan jalur repositori Anda yang sebenarnya
Tambahkan kunci API Needle Anda
Mulai ulang Claude Desktop

Menginstal melalui Smithery

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

3. Instalasi Docker

Kloning dan bangun:

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

Tambahkan ke konfigurasi Claude Desktop Anda (~/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>"
      }
    }
  }
}

Mulai ulang Claude Desktop

Contoh Penggunaan

"Buat koleksi baru bernama 'Dokumen Teknis'"
"Tambahkan dokumen ini ke koleksi, yaitu https://needle.app"
"Cari koleksi untuk informasi tentang AI"
"Daftar semua koleksi saya"

Pemecahan Masalah

Jika tidak berfungsi:

Pastikan uv terinstal secara global (jika tidak, hapus dengan pip uninstall uv dan instal ulang dengan brew install uv)
Atau temukan jalur uv dengan which uv dan ganti "command": "uv" dengan jalur lengkap
Verifikasi kunci API Needle Anda sudah benar
Periksa apakah jalur needle-mcp di konfigurasi sesuai dengan lokasi repositori Anda yang sebenarnya

Atur Ulang Konfigurasi Claude Desktop

Jika Anda melihat konfigurasi lama atau integrasi tidak berfungsi:

Temukan semua file konfigurasi Claude Desktop:

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

Hapus semua data Claude Desktop:

Di MacOS: rm -rf ~/Library/Application\ Support/Claude/*
Di Windows: Hapus isi %APPDATA%/Claude/

Buat konfigurasi baru hanya dengan 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

Keluar sepenuhnya dari Claude Desktop (Command+Q di Mac) dan luncurkan kembali
Jika Anda masih melihat konfigurasi lama:

Periksa file konfigurasi tambahan di lokasi lain
Coba hapus cache browser jika menggunakan versi web
Verifikasi file konfigurasi dibaca dari lokasi yang benar