Claude Desktop을 위한 Pinecone 모델 컨텍스트 프로토콜 서버.

Pinecone 인덱스를 읽고 씁니다.

구성 요소

지엑스피1

자원

서버는 Pinecone 인덱스를 읽고 쓰는 기능을 구현합니다.

도구

• semantic-search : Pinecone 인덱스에서 레코드를 검색합니다.

• read-document : Pinecone 인덱스에서 문서를 읽습니다.

• list-documents : Pinecone 인덱스의 모든 문서를 나열합니다.

• pinecone-stats : 레코드 수, 차원, 네임스페이스를 포함한 Pinecone 인덱스에 대한 통계를 가져옵니다.

• process-document : 문서를 청크로 처리하여 Pinecone 인덱스에 업서트합니다. 청킹, 임베딩, 업서트의 전체 단계를 수행합니다.

참고: 임베딩은 Pinecone의 추론 API를 통해 생성되며, 청킹은 토큰 기반 청커를 통해 수행됩니다. langchain에서 많은 부분을 복사하고 Claude로 디버깅하여 작성되었습니다.

Related MCP server: MCP DuckDuckGo Search Server

빠른 시작

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Pinecone MCP Server를 자동으로 설치하려면:

서버를 설치하세요

Claude를 위해 로컬로 서버를 설치하려면 uv를 사용하는 것이 좋습니다.

또는

아래 설명한 대로 구성을 추가하세요.

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

참고: uv 에 대한 직접 경로를 사용해야 할 수도 있습니다. which uv 사용하여 경로를 찾으세요.

개발/미공개 서버 구성

게시된 서버 구성

Pinecone에 가입하세요

여기에서 Pinecone 계정에 가입할 수 있습니다.

API 키 받기

Pinecone에서 {your-index-name} 대체하는 새 인덱스를 만들고, Pinecone 대시보드에서 API 키를 가져와서 config의 {your-secret-api-key} 대체합니다.

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

1. 종속성 동기화 및 잠금 파일 업데이트:

2. 패키지 배포 빌드:

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

3. PyPI에 게시:

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

• 토큰: --token 또는 UV_PUBLISH_TOKEN

• 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

소스 코드

소스 코드는 GitHub 에서 확인할 수 있습니다.

기여하다

여러분의 아이디어와 피드백을 Bluesky 에 보내거나 이슈를 개설해 주세요.