remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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로 디버깅하여 작성되었습니다.

빠른 시작

Smithery를 통해 설치

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

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

서버를 설치하세요

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

uvx install mcp-pinecone

또는

uv pip install mcp-pinecone

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

클로드 데스크탑

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

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

개발/미공개 서버 구성

"mcpServers": {
  "mcp-pinecone": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "mcp-pinecone"
    ]
  }
}

게시된 서버 구성

"mcpServers": {
  "mcp-pinecone": {
    "command": "uvx",
    "args": [
      "--index-name",
      "{your-index-name}",
      "--api-key",
      "{your-secret-api-key}",
      "mcp-pinecone"
    ]
  }
}

Pinecone에 가입하세요

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

API 키 받기

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

개발

건축 및 출판

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

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

uv sync

패키지 배포 빌드:

uv build

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

PyPI에 게시:

uv publish

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

토큰: --token 또는 UV_PUBLISH_TOKEN
또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

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

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

npx @modelcontextprotocol/inspector uv --directory {project_dir} run mcp-pinecone

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

특허

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

소스 코드

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

기여하다

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

벡터 검색 기능을 갖춘 Pinecone 통합