Pinecone
About
Read and write to a Pinecone vector database using the Model Context Protocol.
Details
- Author
- sirmews
- Categories
- Database, Other, Knowledge Base
Jump to
Setup
Install Pinecone in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/sirmews/mcp-pinecone
Follow the installation instructions in the repository README, then restart your MCP client.
Pinecone Model Context Protocol Server for Claude Desktop.
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
The server implements the ability to read and write to a Pinecone index.
- semantic-search: Search for records in the Pinecone index.
- read-document: Read a document from the Pinecone index.
- list-documents: List all documents in the Pinecone index.
- pinecone-stats: Get stats about the Pinecone index, including the number of records, dimensions, and namespaces.
- process-document: Process a document into chunks and upsert them into the Pinecone index. This performs the overall steps of chunking, embedding, and upserting.
Note: embeddings are generated via Pinecone's inference API and chunking is done with a token-based chunker. Written by copying a lot from langchain and debugging with Claude.
To install Pinecone MCP Server for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install mcp-pinecone --client claude
Recommend usinguvto install the server locally for Claude.
On MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.jsonOn Windows:%APPDATA%/Claude/claude_desktop_config.json
Note: You might need to use the direct path touv. Usewhich uvto find the path.
Development/Unpublished Servers Configuration
"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" ] } }
You can sign up for a Pinecone accounthere.
Create a new index in Pinecone, replacing{your-index-name}and get an API key from the Pinecone dashboard, replacing{your-secret-api-key}in the config.
To prepare the package for distribution:
This will create source and wheel distributions in thedist/directory.
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token:--tokenorUV_PUBLISH_TOKEN
- Or username/password:--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using theMCP Inspector.
You can launch the MCP Inspector vianpmwith this command:
npx @modelcontextprotocol/inspector uv --directory {project_dir} run mcp-pinecone
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
This project is licensed under the MIT License. See theLICENSEfile for details.
The source code is available onGitHub.
Send your ideas and feedback to me onBlueskyor by opening an issue.
An MCP server for vector storage and retrieval using ChromaDB.
Provides semantic search capabilities for PostgreSQL databases using the pgvector extension, with support for multiple embedding providers.
Search, Query and interact with data in your Milvus Vector Database.
A server for interacting with the Astra DB database-as-a-service built on Apache Cassandra.
A vector database server powered by Chroma, enabling semantic document search, metadata filtering, and document management.
Provides AI assistants with persistent memory using ChromaDB vector storage.
An MCP server for the Chroma embedding database, providing persistent, searchable working memory for AI-assisted development with features like automated context recall and codebase indexing.
Interact with on-disk documents using agentic RAG and hybrid search via LanceDB.
A vector database server for storing, searching, and managing vector embeddings.
Vector search using the LanceDB vector database and Ollama embedding models.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
