Skip to content
Back to search

mcp-pinecone

Model Context Protocol server to allow for reading and writing from Pinecone. Rudimentary RAG

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sirmews--mcp-pinecone/badge.svg)](/listings/sirmews--mcp-pinecone)

HTML

<a href="/listings/sirmews--mcp-pinecone"><img src="/api/listings/sirmews--mcp-pinecone/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing via Smithery

To install Pinecone MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-pinecone):

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

Install the server

Recommend using [uv](https://docs.astral.sh/uv/getting-started/installation/) to install the server locally for Claude.

uvx install mcp-pinecone

OR

uv pip install mcp-pinecone

Add your config as described below.

Claude Desktop

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

Note: You might need to use the direct path to `uv`. Use `which uv` to find the path.

__Development/Unpublished Servers Configuration__

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

__Published Servers Configuration__

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

Sign up to Pinecone

You can sign up for a Pinecone account [here](https://www.pinecone.io/).

Get an API key

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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 220 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Pinecone Model Context Protocol Server for Claude Desktop.
  2. [![smithery badge](https://smithery.ai/badge/mcp-pinecone)](https://smithery.ai/server/mcp-pinecone)
  3. [![PyPI - Downloads](https://img.shields.io/pypi/dd/mcp-pinecone?style=flat)](https://pypi.org/project/mcp-pinecone/)
  4. Read and write to a Pinecone index.
  5. ## Components
  6. ```mermaid
  7. flowchart TB
  8. subgraph Client["MCP Client (e.g., Claude Desktop)"]
  9. UI[User Interface]
  10. end
  11. subgraph MCPServer["MCP Server (pinecone-mcp)"]
  12. Server[Server Class]
  13. subgraph Handlers["Request Handlers"]
  14. ListRes[list_resources]
  15. ReadRes[read_resource]
  16. ListTools[list_tools]
  17. CallTool[call_tool]
  18. GetPrompt[get_prompt]
  19. ListPrompts[list_prompts]
  20. end
  21. subgraph Tools["Implemented Tools"]
  22. SemSearch[semantic-search]
  23. ReadDoc[read-document]
  24. ListDocs[list-documents]
  25. PineconeStats[pinecone-stats]
  26. ProcessDoc[process-document]
  27. end
  28. end
  29. subgraph PineconeService["Pinecone Service"]
  30. PC[Pinecone Client]
  31. subgraph PineconeFunctions["Pinecone Operations"]
  32. Search[search_records]
  33. Upsert[upsert_records]
  34. Fetch[fetch_records]
  35. List[list_records]
  36. Embed[generate_embeddings]
  37. end
  38. Index[(Pinecone Index)]
  39. end
  40. %% Connections
  41. UI --> Server
  42. Server --> Handlers
  43. ListTools --> Tools
  44. CallTool --> Tools
  45. Tools --> PC
  46. PC --> PineconeFunctions
  47. PineconeFunctions --> Index
  48. %% Data flow for semantic search
  49. SemSearch --> Search
  50. Search --> Embed
  51. Embed --> Index
  52. %% Data flow for document operations
  53. UpsertDoc --> Upsert
  54. ReadDoc --> Fetch
  55. ListRes --> List
  56. classDef primary fill:#2563eb,stroke:#1d4ed8,color:white
  57. classDef secondary fill:#4b5563,stroke:#374151,color:white
  58. classDef storage fill:#059669,stroke:#047857,color:white
  59. class Server,PC primary
  60. class Tools,Handlers secondary
  61. class Index storage
  62. ```
  63. ### Resources
  64. The server implements the ability to read and write to a Pinecone index.
  65. ### Tools
  66. - `semantic-search`: Search for records in the Pinecone index.
  67. - `read-document`: Read a document from the Pinecone index.
  68. - `list-documents`: List all documents in the Pinecone index.
  69. - `pinecone-stats`: Get stats about the Pinecone index, including the number of records, dimensions, and namespaces.
  70. - `process-document`: Process a document into chunks and upsert them into the Pinecone index. This performs the overall steps of chunking, embedding, and upserting.
  71. 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.
  72. ## Quickstart
  73. ### Installing via Smithery
  74. To install Pinecone MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-pinecone):
  75. ```bash
  76. npx -y @smithery/cli install mcp-pinecone --client claude
  77. ```
  78. ### Install the server
  79. Recommend using [uv](https://docs.astral.sh/uv/getting-started/installation/) to install the server locally for Claude.
  80. ```
  81. uvx install mcp-pinecone
  82. ```
  83. OR
  84. ```
  85. uv pip install mcp-pinecone
  86. ```
  87. Add your config as described below.
  88. #### Claude Desktop
  89. On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
  90. On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  91. Note: You might need to use the direct path to `uv`. Use `which uv` to find the path.
  92. __Development/Unpublished Servers Configuration__
  93. ```json
  94. "mcpServers": {
  95. "mcp-pinecone": {
  96. "command": "uv",
  97. "args": [
  98. "--directory",
  99. "{project_dir}",
  100. "run",
  101. "mcp-pinecone"
  102. ]
  103. }
  104. }
  105. ```
  106. __Published Servers Configuration__
  107. ```json
  108. "mcpServers": {
  109. "mcp-pinecone": {
  110. "command": "uvx",
  111. "args": [
  112. "--index-name",
  113. "{your-index-name}",
  114. "--api-key",
  115. "{your-secret-api-key}",
  116. "mcp-pinecone"
  117. ]
  118. }
  119. }
  120. ```
  121. #### Sign up to Pinecone
  122. You can sign up for a Pinecone account [here](https://www.pinecone.io/).
  123. #### Get an API key
  124. 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.
  125. ## Development
  126. ### Building and Publishing
  127. To prepare the package for distribution:
  128. 1. Sync dependencies and update lockfile:
  129. ```bash
  130. uv sync
  131. ```
  132. 2. Build package distributions:
  133. ```bash
  134. uv build
  135. ```
  136. This will create source and wheel distributions in the `dist/` directory.
  137. 3. Publish to PyPI:
  138. ```bash
  139. uv publish
  140. ```
  141. Note: You'll need to set PyPI credentials via environment variables or command flags:
  142. - Token: `--token` or `UV_PUBLISH_TOKEN`
  143. - Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD`
  144. ### Debugging
  145. Since MCP servers run over stdio, debugging can be challenging. For the best debugging
  146. experience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).
  147. You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command:
  148. ```bash
  149. npx @modelcontextprotocol/inspector uv --directory {project_dir} run mcp-pinecone
  150. ```
  151. Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
  152. ## License
  153. This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
  154. ## Source Code
  155. The source code is available on [GitHub](https://github.com/sirmews/mcp-pinecone).
  156. ## Contributing
  157. Send your ideas and feedback to me on [Bluesky](https://bsky.app/profile/perfectlycromulent.bsky.social) or by opening an issue.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.