What is Assistant Mcp

assistant-mcp is an MCP server implementation designed for retrieving information from Pinecone Assistant, facilitating efficient data access and management.

Use cases

Use cases for assistant-mcp include integrating with applications that require quick access to data, enhancing AI models with real-time data retrieval, and supporting research projects that utilize Pinecone’s capabilities.

How to use

To use assistant-mcp, ensure Docker is installed, obtain a Pinecone API key and Assistant host, then build and run the server using Docker commands provided in the README.

Key features

Key features include the ability to retrieve information from Pinecone Assistant and support for configurable multiple results retrieval.

Where to use

assistant-mcp can be used in various fields such as data analysis, machine learning applications, and any scenario requiring efficient information retrieval from Pinecone Assistant.

Pinecone Assistant MCP Server

An MCP server implementation for retrieving information from Pinecone Assistant.

Features

• Retrieves information from Pinecone Assistant
• Supports multiple results retrieval with a configurable number of results

Prerequisites

• Docker installed on your system
• Pinecone API key - obtain from the Pinecone Console
• Pinecone Assistant API host - after creating an Assistant (e.g. in Pinecone Console), you can find the host in the Assistant details page

Building with Docker

To build the Docker image:

docker build -t pinecone/assistant-mcp .

Running with Docker

Run the server with your Pinecone API key:

docker run -i --rm \
  -e PINECONE_API_KEY=<YOUR_PINECONE_API_KEY_HERE> \
  -e PINECONE_ASSISTANT_HOST=<YOUR_PINECONE_ASSISTANT_HOST_HERE> \
  pinecone/assistant-mcp

Environment Variables

• PINECONE_API_KEY (required): Your Pinecone API key
• PINECONE_ASSISTANT_HOST (optional): Pinecone Assistant API host (default: https://prod-1-data.ke.pinecone.io)
• LOG_LEVEL (optional): Logging level (default: info)

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "pinecone-assistant": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PINECONE_API_KEY",
        "-e",
        "PINECONE_ASSISTANT_HOST",
        "pinecone/assistant-mcp"
      ],
      "env": {
        "PINECONE_API_KEY": "<YOUR_PINECONE_API_KEY_HERE>",
        "PINECONE_ASSISTANT_HOST": "<YOUR_PINECONE_ASSISTANT_HOST_HERE>"
      }
    }
  }
}

Building from Source

If you prefer to build from source without Docker:

1. Make sure you have Rust installed (https://rustup.rs/)
2. Clone this repository
3. Run cargo build --release
4. The binary will be available at target/release/assistant-mcp

Testing with the inspector

export PINECONE_API_KEY=<YOUR_PINECONE_API_KEY_HERE>
export PINECONE_ASSISTANT_HOST=<YOUR_PINECONE_ASSISTANT_HOST_HERE>
# Run the inspector alone
npx @modelcontextprotocol/inspector cargo run
# Or run with Docker directly through the inspector
npx @modelcontextprotocol/inspector -- docker run -i --rm -e PINECONE_API_KEY -e PINECONE_ASSISTANT_HOST pinecone/assistant-mcp

License

This project is licensed under the terms specified in the LICENSE file.