Pinecone Assistant MCP Server

1# Pinecone Assistant MCP Server
2 
3An MCP server implementation for retrieving information from Pinecone Assistant.
4 
5## Features
6 
7- Retrieves information from Pinecone Assistant
8- Supports multiple results retrieval with a configurable number of results
9 
10## Prerequisites
11 
12- Docker installed on your system
13- Pinecone API key - obtain from the [Pinecone Console](https://app.pinecone.io)
14- Pinecone Assistant API host - after creating an Assistant (e.g. in Pinecone Console), you can find the host in the Assistant details page
15 
16## Building with Docker
17 
18To build the Docker image:
19 
20```sh
21docker build -t pinecone/assistant-mcp .
22```
23 
24## Running with Docker
25 
26Run the server with your Pinecone API key:
27 
28```sh
29docker run -i --rm \
30  -e PINECONE_API_KEY=<YOUR_PINECONE_API_KEY_HERE> \
31  -e PINECONE_ASSISTANT_HOST=<YOUR_PINECONE_ASSISTANT_HOST_HERE> \
32  pinecone/assistant-mcp
33```
34 
35### Environment Variables
36 
37- `PINECONE_API_KEY` (required): Your Pinecone API key
38- `PINECONE_ASSISTANT_HOST` (optional): Pinecone Assistant API host (default: https://prod-1-data.ke.pinecone.io)
39- `LOG_LEVEL` (optional): Logging level (default: info)
40 
41## Usage with Claude Desktop
42 
43Add this to your `claude_desktop_config.json`:
44 
45```json
46{
47  "mcpServers": {
48    "pinecone-assistant": {
49      "command": "docker",
50      "args": [
51        "run", 
52        "-i", 
53        "--rm", 
54        "-e", 
55        "PINECONE_API_KEY", 
56        "-e", 
57        "PINECONE_ASSISTANT_HOST", 
58        "pinecone/assistant-mcp"
59      ],
60      "env": {
61        "PINECONE_API_KEY": "<YOUR_PINECONE_API_KEY_HERE>",
62        "PINECONE_ASSISTANT_HOST": "<YOUR_PINECONE_ASSISTANT_HOST_HERE>"
63      }
64    }
65  }
66}
67```
68 
69## Building from Source
70 
71If you prefer to build from source without Docker:
72 
731. Make sure you have Rust installed (https://rustup.rs/)
742. Clone this repository
753. Run `cargo build --release`
764. The binary will be available at `target/release/assistant-mcp`
77 
78### Testing with the inspector
79```sh
80export PINECONE_API_KEY=<YOUR_PINECONE_API_KEY_HERE>
81export PINECONE_ASSISTANT_HOST=<YOUR_PINECONE_ASSISTANT_HOST_HERE>
82# Run the inspector alone
83npx @modelcontextprotocol/inspector cargo run
84# Or run with Docker directly through the inspector
85npx @modelcontextprotocol/inspector -- docker run -i --rm -e PINECONE_API_KEY -e PINECONE_ASSISTANT_HOST pinecone/assistant-mcp
86```
87 
88## License
89 
90This project is licensed under the terms specified in the LICENSE file.
91