Needle MCP 서버를 사용하여 에이전트 빌드

Claude의 데스크톱 애플리케이션을 통해 Needle을 사용하여 문서를 관리하고 검색을 수행하는 MCP(Model Context Protocol) 서버입니다.

개요

Needle MCP 서버를 사용하면 다음 작업을 수행할 수 있습니다.

빠른 검색을 위해 문서를 정리하고 보관하세요.
클로드의 대규모 언어 모델을 통해 강력한 검색을 수행합니다.
고급 문서 관리를 위해 Needle 생태계와 완벽하게 통합됩니다.

특징

문서 관리: 서버에서 문서를 쉽게 추가하고 정리할 수 있습니다.
검색 및 불러오기: 빠른 답변을 위한 Claude 기반 자연어 검색.
간편한 통합: Claude Desktop 및 Needle 컬렉션과 호환됩니다.

용법

Claude Desktop의 명령

다음은 Claude Desktop에서 명령을 사용하여 서버와 상호 작용하는 방법의 예입니다.

Claude Desktop을 열고 Needle MCP 서버에 연결합니다.
간단한 텍스트 명령을 사용하여 문서를 검색, 꺼내오거나 수정합니다.
사용자 친화적인 인터페이스에서 클로드가 반환한 검색 결과를 검토하세요 .

바늘에 결과

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

유튜브 영상 설명

Claude와 Claude Desktop에서 Needle MCP 서버를 사용하는 방법에 대한 전체적인 연습을 보려면 이 YouTube 설명 비디오를 시청하세요.

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Needle MCP를 자동으로 설치하려면:

지엑스피1

수동 설치

저장소를 복제합니다.

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

터미널에서 Homebrew를 사용하여 UV를 전역적으로 설치하세요.

brew install uv

claude_desktop_config.json을 생성합니다.
- MacOS의 경우: ~/Library/Application Support/Claude/ 디렉토리를 열고 그 안에 파일을 만듭니다.
- Windows의 경우: %APPDATA%/Claude/ 디렉토리를 열고 그 안에 파일을 만듭니다.
claude_desktop_config.json에 이 구성을 추가합니다.

{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}

needle.xyz에서 Needle API 키를 받으세요
구성 파일을 업데이트합니다.
- /path/to/needle-mcp 실제 저장소 경로로 바꾸세요.
- Needle API 키를 추가하세요
Claude를 완전히 종료하고 다시 열어보세요.

사용 예

"'기술 문서'라는 새 컬렉션을 만듭니다."
"이 문서를 https://needle-ai.com 컬렉션에 추가하세요."
"AI에 대한 정보를 컬렉션에서 검색하세요"
"내 모든 컬렉션 나열"

문제 해결

작동하지 않는 경우:

UV가 전역적으로 설치되어 있는지 확인하세요(그렇지 않은 경우 pip uninstall uv 로 제거하고 brew install uv 로 다시 설치하세요)
또는 which uv 포함된 UV 경로를 찾아 "command": "uv" 전체 경로로 바꾸세요.
Needle API 키가 올바른지 확인하세요
config의 needle-mcp 경로가 실제 저장소 위치와 일치하는지 확인하세요.

Claude 데스크톱 구성 재설정

이전 구성이 표시되거나 통합이 작동하지 않는 경우:

모든 Claude Desktop 구성 파일을 찾으세요:

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

모든 Claude Desktop 데이터를 제거합니다.

MacOS의 경우: rm -rf ~/Library/Application\ Support/Claude/*
Windows에서: %APPDATA%/Claude/ 의 내용을 삭제합니다.

Needle만 사용하여 새로운 구성을 만듭니다.

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

Claude Desktop을 완전히 종료하고(Mac에서는 Command+Q) 다시 시작합니다.
여전히 이전 구성이 표시되는 경우:

다른 위치에 추가 구성 파일이 있는지 확인하세요.
웹 버전을 사용하는 경우 브라우저 캐시를 지워보세요.
구성 파일이 올바른 위치에서 읽혀지고 있는지 확인하세요.

Needle MCP Server