Needle MCP Server

resmi

Kendi belgelerinizden veri aramak ve almak için kullanıma hazır, üretime uygun RAG.

Dokümantasyon

Needle MCP Sunucusu ile Ajanlar Oluşturun

Screenshot of Feature - Claude

Claude Masaüstü Uygulaması aracılığıyla Needle kullanarak belgeleri yönetmek ve aramalar yapmak için MCP (Model Bağlam Protokolü) sunucusu.

İçindekiler

Genel Bakış
Özellikler
Kullanım
- Claude Desktop'ta Komutlar
- Needle'da Sonuç
Kurulum
Video Açıklaması

Genel Bakış

Needle MCP Sunucusu şunları yapmanızı sağlar:

Hızlı erişim için belgeleri düzenleyin ve saklayın.
Claude'un büyük dil modeli aracılığıyla güçlü aramalar gerçekleştirin.
Gelişmiş belge yönetimi için Needle ekosistemiyle sorunsuz bir şekilde entegre olun.

MCP (Model Bağlam Protokolü), LLM'lerin harici veri kaynaklarına bağlanma şeklini standartlaştırır. Needle MCP Sunucusunu kullanarak yapay zeka uygulamalarınızda anlamsal arama araçlarını kolayca etkinleştirebilir, PDF, DOCX, XLSX ve diğer dosyalarda gömülü verileri LLM'ler tarafından anında erişilebilir hale getirebilirsiniz.

En iyi deneyim için uzak MCP sunucumuzu kullanmanızı öneririz - yerel kurulum gerekmez.

Özellikler

Belge Yönetimi: Belgeleri sunucuya kolayca ekleyin ve düzenleyin.
Arama ve Erişim: Hızlı yanıtlar için Claude tabanlı doğal dil araması.
Kolay Entegrasyon: Claude Desktop ve Needle koleksiyonlarıyla çalışır.

Kullanım

Claude Desktop'ta Komutlar

Aşağıda, sunucuyla etkileşim kurmak için Claude Desktop'ta komutların nasıl kullanılabileceğine dair bir örnek verilmiştir:

Using commands in Claude Desktop

Claude Desktop'ı açın ve Needle MCP Sunucusuna bağlanın.
Basit metin komutları kullanın arama yapmak, belgelere erişmek veya belgeleri değiştirmek için.
Claude tarafından döndürülen arama sonuçlarını kullanıcı dostu bir arayüzde inceleyin.

Needle'da Sonuç

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

Youtube Video Açıklaması

Needle MCP Sunucusunu Claude ve Claude Desktop ile kullanma hakkında kapsamlı bir anlatım için bu YouTube açıklama videosunu izleyin.

Kurulum

1. Uzak MCP Sunucusu (Önerilen)

Claude Desktop Yapılandırması

Yapılandırma dosyanızı oluşturun veya güncelleyin:

MacOS için: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows için: %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 Yapılandırması

.cursor/mcp.json dosyasını oluşturun veya güncelleyin:

{
  "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 anahtarınızı Needle Ayarları sayfasından alın.

İki uç nokta sağlıyoruz:

Akışkan HTTP: https://mcp.needle.app/mcp (önerilir)
SSE: https://mcp.needle.app/sse

Not: MCP, en son spesifikasyonda SSE uç noktalarını kullanımdan kaldırdı, bu nedenle daha yeni istemciler Akışkan HTTP uç noktasını tercih etmelidir.

2. Yerel Kurulum

Depoyu klonlayın:

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

Homebrew kullanarak UV'yi global olarak yükleyin:

brew install uv

Yapılandırma dosyanızı oluşturun:
- MacOS için: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows için: %APPDATA%/Claude/claude_desktop_config.json

Claude Desktop Yapılandırması

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

Cursor Yapılandırması

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

/path/to/needle-mcp kısmını gerçek depo yolunuzla değiştirin
Needle API anahtarınızı ekleyin
Claude Desktop'ı yeniden başlatın

Smithery ile Kurulum

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

3. Docker Kurulumu

Klonlayın ve oluşturun:

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

Claude Desktop yapılandırmanıza ekleyin (~/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>"
      }
    }
  }
}

Claude Desktop'ı yeniden başlatın

Kullanım Örnekleri

"'Teknik Dokümanlar' adında yeni bir koleksiyon oluştur"
"Bu belgeyi koleksiyona ekle, ki bu https://needle.app"
"Koleksiyonda yapay zeka hakkında bilgi ara"
"Tüm koleksiyonlarımı listele"

Sorun Giderme

Çalışmıyorsa:

uv uygulamasının global olarak yüklü olduğundan emin olun (değilse, pip uninstall uv ile kaldırın ve brew install uv ile yeniden yükleyin)
Veya uv yolunu which uv ile bulun ve "command": "uv" kısmını tam yol ile değiştirin
Needle API anahtarınızın doğru olduğunu doğrulayın
Yapılandırmadaki needle-mcp yolunun gerçek depo konumunuzla eşleşip eşleşmediğini kontrol edin

Claude Desktop Yapılandırmasını Sıfırlama

Eski yapılandırmaları görüyorsanız veya entegrasyon çalışmıyorsa:

Tüm Claude Desktop yapılandırma dosyalarını bulun:

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

Tüm Claude Desktop verilerini kaldırın:

MacOS'ta: rm -rf ~/Library/Application\ Support/Claude/*
Windows'ta: %APPDATA%/Claude/ içeriğini silin

Yalnızca Needle ile yeni bir yapılandırma oluşturun:

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

Claude Desktop'ı tamamen kapatın (Mac'te Command+Q) ve yeniden başlatın
Hala eski yapılandırmaları görüyorsanız:

Diğer konumlardaki ek yapılandırma dosyalarını kontrol edin
Web sürümünü kullanıyorsanız tarayıcı önbelleğini temizlemeyi deneyin
Yapılandırma dosyasının doğru konumdan okunduğunu doğrulayın