Pinecone Developer MCP Server

Что умеет сервер

Pinecone Developer MCP Server выпускает сама компания Pinecone, он опубликован в npm как @pinecone-database/mcp. Назначение сервера, по словам авторов, в том, чтобы улучшить работу разработчиков, которые используют Pinecone, и рассчитан он на ассистентов для программирования. Сервер связывает такие инструменты с проектами Pinecone и документацией.

Набор инструментов: поиск по официальной документации Pinecone (search-docs), список индексов и описание конфигурации индекса, статистика индекса с числом записей и пространствами имён, создание индекса с встроенной моделью эмбеддингов, вставка и обновление записей, поиск записей по текстовому запросу с фильтрами по метаданным и переранжированием, каскадный поиск по нескольким индексам с дедупликацией и отдельное переранжирование документов.

Когда использовать

Подходит, когда вы разрабатываете приложение с Pinecone и хотите, чтобы помощник в редакторе знал вашу конфигурацию: сверялся с документацией, подбирал параметры индекса, писал код с учётом реальных данных, а ещё загружал пробные записи и сразу проверял качество поиска. README приводит примеры просьб: найти в документации про фильтрацию метаданных, перечислить все индексы, создать индекс my-docs на модели multilingual-e5-large, показать пространства имён и число записей в каждом.

Ограничения и безопасность

Поддерживаются только индексы со встроенным инференсом (integrated inference). Ассистенты Pinecone, индексы без встроенного инференса, отдельные эмбеддинги и векторный поиск этим сервером не поддерживаются. Для работы с базой знаний, из которой ассистенту нужен контекст, Pinecone предлагает отдельный сервер Assistant MCP.

Для работы с индексами нужен ключ API из консоли Pinecone в переменной PINECONE_API_KEY. Без ключа доступен только поиск по документации. Агент с ключом может создавать индексы и менять записи, а клиент перед вызовом инструмента может запрашивать разрешение, поэтому внимательно читайте такие запросы. Нужен Node.js версии 20 или новее, а node и npx должны быть в PATH. README советует задать для Cursor правила, которые подскажут, как правильно пользоваться сервером.

Cursor

Создайте файл .cursor/mcp.json в корне проекта (или в домашнем каталоге, чтобы включить сервер глобально) и добавьте:

{
  "mcpServers": {
    "pinecone": {
      "command": "npx",
      "args": [
        "-y", "@pinecone-database/mcp"
      ],
      "env": {
        "PINECONE_API_KEY": "<your pinecone api key>"
      }
    }
  }
}

Состояние сервера можно проверить в Cursor Settings, вкладка MCP.

Claude Desktop

В Claude Desktop откройте Settings, Developer, Edit Config и добавьте ту же конфигурацию:

{
  "mcpServers": {
    "pinecone": {
      "command": "npx",
      "args": [
        "-y", "@pinecone-database/mcp"
      ],
      "env": {
        "PINECONE_API_KEY": "<your pinecone api key>"
      }
    }
  }
}

Перезапустите Claude Desktop. На экране нового чата появится значок молотка (MCP) с новыми инструментами.

Gemini CLI

Установка как расширения Gemini CLI:

gemini extensions install https://github.com/pinecone-io/pinecone-mcp

Укажите ключ API в переменной окружения:

export PINECONE_API_KEY=<your pinecone api key>