Pinecone

Servidor de Protocolo de Contexto de Modelo (MCP) de Pinecone para Claude Desktop.

Lee y escribe en un índice de Pinecone.

Componentes

flowchart TB
    subgraph Client["MCP Client (e.g., Claude Desktop)"]
        UI[User Interface]
    end

    subgraph MCPServer["MCP Server (pinecone-mcp)"]
        Server[Server Class]
        
        subgraph Handlers["Request Handlers"]
            ListRes[list_resources]
            ReadRes[read_resource]
            ListTools[list_tools]
            CallTool[call_tool]
            GetPrompt[get_prompt]
            ListPrompts[list_prompts]
        end
        
        subgraph Tools["Implemented Tools"]
            SemSearch[semantic-search]
            ReadDoc[read-document]
            ListDocs[list-documents]
            PineconeStats[pinecone-stats]
            ProcessDoc[process-document]
        end
    end

    subgraph PineconeService["Pinecone Service"]
        PC[Pinecone Client]
        subgraph PineconeFunctions["Pinecone Operations"]
            Search[search_records]
            Upsert[upsert_records]
            Fetch[fetch_records]
            List[list_records]
            Embed[generate_embeddings]
        end
        Index[(Pinecone Index)]
    end

    %% Connections
    UI --> Server
    Server --> Handlers
    
    ListTools --> Tools
    CallTool --> Tools
    
    Tools --> PC
    PC --> PineconeFunctions
    PineconeFunctions --> Index
    
    %% Data flow for semantic search
    SemSearch --> Search
    Search --> Embed
    Embed --> Index
    
    %% Data flow for document operations
    UpsertDoc --> Upsert
    ReadDoc --> Fetch
    ListRes --> List

    classDef primary fill:#2563eb,stroke:#1d4ed8,color:white
    classDef secondary fill:#4b5563,stroke:#374151,color:white
    classDef storage fill:#059669,stroke:#047857,color:white
    
    class Server,PC primary
    class Tools,Handlers secondary
    class Index storage

Recursos

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

Herramientas

• semantic-search: Busca registros en el índice de Pinecone.
• read-document: Lee un documento del índice de Pinecone.
• list-documents: Lista todos los documentos en el índice de Pinecone.
• pinecone-stats: Obtiene estadísticas sobre el índice de Pinecone, incluido el número 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 e 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 mucho de langchain y depurando con Claude.

Inicio rápido

Instalación mediante Smithery

Para instalar el Servidor MCP de Pinecone para Claude Desktop automáticamente mediante Smithery:

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

Instalar el servidor

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

uvx install mcp-pinecone

O

uv pip install mcp-pinecone

Agrega tu configuración como se describe a continuación.

Claude Desktop

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 en desarrollo/no publicados

"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 crear una cuenta de Pinecone aquí.

Obtén una clave de API

Crea un nuevo índice en Pinecone, reemplazando {your-index-name} y obtén una clave de API desde el panel de Pinecone, reemplazando {your-secret-api-key} en la configuración.

Desarrollo

Compilación y publicación

Para preparar el paquete para su distribución:

1. Sincroniza las dependencias y actualiza el archivo de bloqueo:

uv sync

2. Compila las distribuciones del paquete:

uv build

Esto creará distribuciones de código fuente y rueda en el directorio dist/.

3. Publica en PyPI:

uv publish

Nota: Necesitarás configurar las credenciales de PyPI mediante variables de entorno o banderas 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 a través de stdio, la depuración puede ser un desafío. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el Inspector MCP.

Puedes iniciar el Inspector MCP mediante npm con este comando:

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

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

Licencia

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

Código fuente

El código fuente está disponible en GitHub.

Contribuciones

Envía tus ideas y comentarios a Bluesky o abriendo un problema.