Needle MCP Server

chính thức

RAG sẵn sàng cho sản xuất để tìm kiếm và truy xuất dữ liệu từ tài liệu của bạn.

GitHub
99

Tài liệu

Xây dựng Agent với Needle MCP Server

smithery badge

Screenshot of Feature - Claude

MCP (Model Context Protocol) server để quản lý tài liệu và thực hiện tìm kiếm bằng Needle thông qua Ứng dụng Claude Desktop.

Needle Server MCP server

Mục lục

Tổng quan

Needle MCP Server cho phép bạn:

  • Sắp xếp và lưu trữ tài liệu để truy xuất nhanh chóng.
  • Thực hiện tìm kiếm mạnh mẽ thông qua mô hình ngôn ngữ lớn của Claude.
  • Tích hợp liền mạch với hệ sinh thái Needle để quản lý tài liệu nâng cao.

MCP (Model Context Protocol) chuẩn hóa cách các LLM kết nối với nguồn dữ liệu bên ngoài. Bạn có thể sử dụng Needle MCP Server để dễ dàng kích hoạt công cụ tìm kiếm ngữ nghĩa trong ứng dụng AI của mình, giúp dữ liệu ẩn trong các tệp PDF, DOCX, XLSX và các tệp khác có thể được LLM truy cập ngay lập tức.

Chúng tôi khuyên bạn nên sử dụng máy chủ MCP từ xa để có trải nghiệm tốt nhất - không cần thiết lập cục bộ.

Tính năng

  • Quản lý tài liệu: Dễ dàng thêm và sắp xếp tài liệu trên máy chủ.
  • Tìm kiếm & Truy xuất: Tìm kiếm ngôn ngữ tự nhiên dựa trên Claude để có câu trả lời nhanh chóng.
  • Tích hợp dễ dàng: Hoạt động với Claude Desktop và các bộ sưu tập Needle.

Cách sử dụng

Lệnh trong Claude Desktop

Dưới đây là ví dụ về cách các lệnh có thể được sử dụng trong Claude Desktop để tương tác với máy chủ:

Using commands in Claude Desktop

  1. Mở Claude Desktop và kết nối với Needle MCP Server.
  2. Sử dụng lệnh văn bản đơn giản để tìm kiếm, truy xuất hoặc sửa đổi tài liệu.
  3. Xem lại kết quả tìm kiếm do Claude trả về trong giao diện thân thiện với người dùng.

Kết quả trong Needle

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

Video giải thích trên Youtube

Để có hướng dẫn đầy đủ về cách sử dụng Needle MCP Server với Claude và Claude Desktop, hãy xem video giải thích trên YouTube này.

Cài đặt

1. Máy chủ MCP từ xa (Khuyến nghị)

Cấu hình Claude Desktop

Tạo hoặc cập nhật tệp cấu hình của bạn:

  • Đối với MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Đối với 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>"
      }
    }
  }
}

Cấu hình Cursor

Tạo hoặc cập nhật .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>"
      }
    }
  }
}

Lấy khóa API của bạn từ Cài đặt Needle.

Chúng tôi cung cấp hai điểm cuối:

  • HTTP có thể truyền phát: https://mcp.needle.app/mcp (khuyến nghị)
  • SSE: https://mcp.needle.app/sse

Lưu ý: MCP đã không dùng các điểm cuối SSE trong đặc tả mới nhất, vì vậy các máy khách mới hơn nên ưu tiên điểm cuối HTTP có thể truyền phát.

2. Cài đặt cục bộ

  1. Sao chép kho lưu trữ:
git clone https://github.com/needle-ai/needle-mcp.git
  1. Cài đặt UV toàn cục bằng Homebrew:
brew install uv
  1. Tạo tệp cấu hình của bạn:
    • Đối với MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Đối với Windows: %APPDATA%/Claude/claude_desktop_config.json

Cấu hình Claude Desktop

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

Cấu hình Cursor

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}
  1. Thay thế /path/to/needle-mcp bằng đường dẫn kho lưu trữ thực tế của bạn
  2. Thêm khóa API Needle của bạn
  3. Khởi động lại Claude Desktop

Cài đặt qua Smithery

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

3. Cài đặt Docker

  1. Sao chép và xây dựng:
git clone https://github.com/needle-ai/needle-mcp.git
cd needle-mcp
docker build -t needle-mcp .
  1. Thêm vào cấu hình Claude Desktop của bạn (~/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>"
      }
    }
  }
}
  1. Khởi động lại Claude Desktop

Ví dụ sử dụng

  • "Tạo một bộ sưu tập mới có tên 'Tài liệu kỹ thuật'"
  • "Thêm tài liệu này vào bộ sưu tập, đó là https://needle.app"
  • "Tìm kiếm trong bộ sưu tập thông tin về AI"
  • "Liệt kê tất cả các bộ sưu tập của tôi"

Khắc phục sự cố

Nếu không hoạt động:

  • Đảm bảo uv được cài đặt toàn cục (nếu không, gỡ cài đặt bằng pip uninstall uv và cài đặt lại bằng brew install uv)
  • Hoặc tìm đường dẫn uv bằng which uv và thay thế "command": "uv" bằng đường dẫn đầy đủ
  • Xác minh khóa API Needle của bạn là chính xác
  • Kiểm tra xem đường dẫn needle-mcp trong cấu hình có khớp với vị trí kho lưu trữ thực tế của bạn không

Đặt lại cấu hình Claude Desktop

Nếu bạn thấy cấu hình cũ hoặc tích hợp không hoạt động:

  1. Tìm tất cả các tệp cấu hình Claude Desktop:
find / -name "claude_desktop_config.json" 2>/dev/null
  1. Xóa tất cả dữ liệu Claude Desktop:
  • Trên MacOS: rm -rf ~/Library/Application\ Support/Claude/*
  • Trên Windows: Xóa nội dung của %APPDATA%/Claude/
  1. Tạo cấu hình mới chỉ với 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

  1. Thoát hoàn toàn Claude Desktop (Command+Q trên Mac) và khởi chạy lại

  2. Nếu bạn vẫn thấy cấu hình cũ:

  • Kiểm tra các tệp cấu hình bổ sung ở các vị trí khác
  • Thử xóa bộ nhớ cache trình duyệt nếu sử dụng phiên bản web
  • Xác minh tệp cấu hình đang được đọc từ đúng vị trí