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.

Servidor de protocolo de contexto del modelo Pinecone para Claude Desktop.

Leer y escribir en un índice Pinecone.

Componentes

Recursos

El servidor implementa la capacidad de leer y escribir en un índice Pinecone.

Herramientas

semantic-search : busca registros en el índice Pinecone.
read-document : Lee un documento del índice de Pinecone.
list-documents : enumera todos los documentos en el índice de Pinecone.
pinecone-stats : obtiene estadísticas sobre el índice Pinecone, incluidos la cantidad de registros, dimensiones y espacios de nombres.
process-document : Procesa un documento en fragmentos y los inserta en el índice de Pinecone. Esto realiza los pasos generales de fragmentación, incrustación y inserción.

Nota: Las incrustaciones se generan mediante la API de inferencia de Pinecone y la fragmentación se realiza con un fragmentador basado en tokens. Escrito copiando gran parte de langchain y depurando con Claude.

Inicio rápido

Instalación mediante herrería

Para instalar Pinecone MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalar el servidor

Se recomienda utilizar uv para instalar el servidor localmente para Claude.

uvx install mcp-pinecone

O

uv pip install mcp-pinecone

Agregue su configuración como se describe a continuación.

Escritorio de Claude

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

Nota: Es posible que necesites usar la ruta directa a uv . Usa which uv para encontrar la ruta.

Configuración de servidores no publicados/desarrollo

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

Configuración de servidores publicados

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

Regístrate en Pinecone

Puedes registrarte para obtener una cuenta Pinecone aquí .

Obtener una clave API

Cree un nuevo índice en Pinecone, reemplazando {your-index-name} y obtenga una clave API del panel de Pinecone, reemplazando {your-secret-api-key} en la configuración.

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

Token: --token o UV_PUBLISH_TOKEN
O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

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

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Código fuente

El código fuente está disponible en GitHub .

Contribuyendo

Envíeme sus ideas y comentarios a través de Bluesky o abriendo un problema.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Integración de Pinecone con capacidades de búsqueda vectorial