Needle MCP Server

Needle MCP सर्वर के साथ एजेंट बनाएँ

MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) सर्वर, Claude के डेस्कटॉप एप्लिकेशन के माध्यम से Needle का उपयोग करके दस्तावेज़ प्रबंधित करने और खोज करने के लिए।

विषय-सूची

• अवलोकन
• विशेषताएँ
• उपयोग
  • Claude डेस्कटॉप में कमांड
  • Needle में परिणाम
• इंस्टॉलेशन
• वीडियो व्याख्या

---

अवलोकन

Needle MCP सर्वर आपको निम्नलिखित की अनुमति देता है:

• त्वरित पुनर्प्राप्ति के लिए दस्तावेज़ों को व्यवस्थित और संग्रहीत करें।
• Claude के बड़े भाषा मॉडल के माध्यम से शक्तिशाली खोजें करें।
• उन्नत दस्तावेज़ प्रबंधन के लिए Needle इकोसिस्टम के साथ सहजता से एकीकृत करें।

MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) LLM के बाहरी डेटा स्रोतों से जुड़ने के तरीके को मानकीकृत करता है। आप Needle MCP सर्वर का उपयोग करके अपने AI अनुप्रयोगों में सिमैंटिक खोज उपकरणों को आसानी से सक्षम कर सकते हैं, जिससे PDF, DOCX, XLSX और अन्य फ़ाइलों में दबा डेटा LLM द्वारा तुरंत सुलभ हो जाता है।

हम सर्वोत्तम अनुभव के लिए हमारे रिमोट MCP सर्वर का उपयोग करने की सलाह देते हैं - किसी स्थानीय सेटअप की आवश्यकता नहीं है।

---

विशेषताएँ

• दस्तावेज़ प्रबंधन: सर्वर पर आसानी से दस्तावेज़ जोड़ें और व्यवस्थित करें।
• खोज और पुनर्प्राप्ति: त्वरित उत्तरों के लिए Claude-आधारित प्राकृतिक भाषा खोज।
• आसान एकीकरण: Claude डेस्कटॉप और Needle संग्रहों के साथ काम करता है।

---

उपयोग

Claude डेस्कटॉप में कमांड

नीचे एक उदाहरण दिया गया है कि सर्वर के साथ इंटरैक्ट करने के लिए Claude डेस्कटॉप में कमांड का उपयोग कैसे किया जा सकता है:

1. Claude डेस्कटॉप खोलें और Needle MCP सर्वर से कनेक्ट करें।
2. सरल टेक्स्ट कमांड का उपयोग करें दस्तावेज़ खोजने, पुनर्प्राप्त करने या संशोधित करने के लिए।
3. खोज परिणामों की समीक्षा करें जो Claude द्वारा उपयोगकर्ता-अनुकूल इंटरफ़ेस में लौटाए गए हैं।

Needle में परिणाम

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

---

यूट्यूब वीडियो व्याख्या

Claude और Claude डेस्कटॉप के साथ Needle MCP सर्वर का उपयोग करने पर पूर्ण विवरण के लिए, यह YouTube व्याख्या वीडियो देखें।

---

इंस्टॉलेशन

1. रिमोट MCP सर्वर (अनुशंसित)

Claude डेस्कटॉप कॉन्फ़िग

अपनी कॉन्फ़िग फ़ाइल बनाएँ या अपडेट करें:

• MacOS के लिए: ~/Library/Application Support/Claude/claude_desktop_config.json
• विंडोज के लिए: %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/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 सेटिंग्स से प्राप्त करें।

हम दो एंडपॉइंट प्रदान करते हैं:

• स्ट्रीमेबल HTTP: https://mcp.needle.app/mcp (अनुशंसित)
• SSE: https://mcp.needle.app/sse

नोट: MCP ने नवीनतम विनिर्देश में SSE एंडपॉइंट को हटा दिया है, इसलिए नए क्लाइंट को स्ट्रीमेबल HTTP एंडपॉइंट को प्राथमिकता देनी चाहिए।

2. स्थानीय इंस्टॉलेशन

1. रिपॉजिटरी क्लोन करें:

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

2. Homebrew का उपयोग करके UV को वैश्विक रूप से इंस्टॉल करें:

brew install uv

3. अपनी कॉन्फ़िग फ़ाइल बनाएँ:
   • MacOS के लिए: ~/Library/Application Support/Claude/claude_desktop_config.json
   • विंडोज के लिए: %APPDATA%/Claude/claude_desktop_config.json

Claude डेस्कटॉप कॉन्फ़िग

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

कर्सर कॉन्फ़िग

{
  "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. अपनी Needle API कुंजी जोड़ें
6. Claude डेस्कटॉप को पुनरारंभ करें

Smithery के माध्यम से इंस्टॉल करना

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

3. डॉकर इंस्टॉलेशन

1. क्लोन करें और बिल्ड करें:

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

2. अपने Claude डेस्कटॉप कॉन्फ़िग (~/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 डेस्कटॉप को पुनरारंभ करें

उपयोग के उदाहरण

• " 'तकनीकी दस्तावेज़' नामक एक नया संग्रह बनाएँ"
• "इस दस्तावेज़ को संग्रह में जोड़ें, जो https://needle.app है"
• "AI के बारे में जानकारी के लिए संग्रह खोजें"
• "मेरे सभी संग्रहों की सूची बनाएँ"

समस्या निवारण

यदि काम नहीं कर रहा है:

• सुनिश्चित करें कि uv वैश्विक रूप से इंस्टॉल है (यदि नहीं, तो pip uninstall uv से अनइंस्टॉल करें और brew install uv से पुनः इंस्टॉल करें)
• या which uv के साथ uv पथ खोजें और "command": "uv" को पूर्ण पथ से बदलें
• सत्यापित करें कि आपकी Needle API कुंजी सही है
• जाँचें कि कॉन्फ़िग में needle-mcp पथ आपके वास्तविक रिपॉजिटरी स्थान से मेल खाता है

Claude डेस्कटॉप कॉन्फ़िगरेशन रीसेट करें

यदि आप पुराने कॉन्फ़िगरेशन देख रहे हैं या एकीकरण काम नहीं कर रहा है:

1. सभी Claude डेस्कटॉप कॉन्फ़िग फ़ाइलें खोजें:

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

2. सभी Claude डेस्कटॉप डेटा हटाएँ:

• MacOS पर: rm -rf ~/Library/Application\ Support/Claude/*
• विंडोज पर: %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 डेस्कटॉप को पूरी तरह से छोड़ें (Mac पर Command+Q) और इसे पुनः लॉन्च करें

5. यदि आप अभी भी पुराने कॉन्फ़िगरेशन देखते हैं:

• अन्य स्थानों में अतिरिक्त कॉन्फ़िग फ़ाइलों की जाँच करें
• यदि वेब संस्करण का उपयोग कर रहे हैं तो ब्राउज़र कैश साफ़ करने का प्रयास करें
• सत्यापित करें कि कॉन्फ़िग फ़ाइल सही स्थान से पढ़ी जा रही है