Правила сервера и курсора Tecton MCP

Tecton's Co-Pilot состоит из MCP Server и правил Cursor. Прочтите этот блог , чтобы узнать больше.

ℹ️ Информация : Это руководство поможет вам настроить сервер Tecton MCP с этим репозиторием и настроить репозиторий функций для его использования при разработке функций с помощью Tecton.

Быстрый старт

Клонируйте этот репозиторий на свой локальный компьютер:
git clone https://github.com/tecton-ai/tecton-mcp.git cd tecton-mcp pwd
Примечание: Путь к каталогу, в который вы только что клонировали репозиторий, в следующих шагах будет называться <path-to-your-local-clone> . Команда pwd в конце сообщит вам полный путь.
Установите менеджер пакетов uv:
brew install uv
Проверьте установку, выполнив следующую команду. Замените <path-to-your-local-clone> на путь, по которому вы клонировали репозиторий на шаге 1:
MCP_SMOKE_TEST=1 uv --directory <path-to-your-local-clone> run mcp run src/tecton_mcp/mcp_server/server.py
Команда должна завершиться без ошибок и вывести сообщение, похожее на MCP_SMOKE_TEST is set. Exiting after initialization. . Это подтверждает, что ваша локальная настройка работает правильно — Cursor автоматически создаст сервер MCP как подпроцесс при необходимости.
Настройте Cursor (или любой другой клиент MCP) с сервером MCP (см. ниже)
Войдите в свой кластер Tecton:
tecton login yourcluster.tecton.ai
Запустите Cursor и начните разрабатывать функции с помощью Tecton Co-Pilot в Cursor!

Инструменты Tecton MCP

Сервер Tecton MCP предоставляет следующие инструменты, которые может использовать клиент MCP (например, Cursor):

Название инструмента	Описание
`query_example_code_snippet_index_tool`	Находит соответствующие примеры кода Tecton с использованием векторной базы данных. Полезно для поиска шаблонов использования перед написанием нового кода Tecton.
`query_documentation_index_tool`	Извлекает фрагменты документации Tecton на основе запроса. Предоставляет контекст непосредственно из официальной документации Tecton.
`get_full_tecton_sdk_reference_tool`	Извлекает полную справку Tecton SDK, включая все доступные классы и функции. Используйте, когда необходим широкий обзор SDK.
`query_tecton_sdk_reference_tool`	Извлекает ссылку на Tecton SDK для указанного списка классов или функций. Идеально подходит для целевой информации о конкретных компонентах SDK.

Архитектура

Tecton MCP интегрируется с редакторами на базе LLM, такими как Cursor, для предоставления контекста на основе инструментов и помощи в проектировании функций:

Архитектура Tecton MCP

Общий процесс создания объектов с помощью Tecton MCP выглядит следующим образом:

Схема потока Tecton MCP

Настройка Тектона с помощью курсора

Следующее протестировано с Cursor 0.48 и выше

Настройте сервер Tecton MCP в Cursor

Перейдите в Cursor Settings -> MCP и нажмите кнопку "Add new global MCP server", которая отредактирует файл mcp.json Cursor. Добавьте Tecton в качестве сервера MCP. Вы можете использовать следующую конфигурацию в качестве отправной точки - убедитесь, что вы изменили путь <path-to-your-local-clone> , чтобы он соответствовал каталогу, в который вы клонировали репозиторий:

{ "mcpServers": { "tecton": { "command": "uv", "args": [ "--directory", "<path-to-your-local-clone>", "run", "mcp", "run", "src/tecton_mcp/mcp_server/server.py" ] } } }

Добавить правила курсора

Скопируйте cursorrules из папки этого репозитория в папку .cursor/rules вашего репозитория функций :

# Create the .cursor/rules directory structure in your feature repository mkdir -p <path-to-your-feature-repo>/.cursor/rules # Then copy the rules cp -r <path-to-your-local-clone>/.cursor/rules/* <path-to-your-feature-repo>/.cursor/rules/

Тектон Войти

Войдите в свой кластер Tecton:

tecton login yourcluster.tecton.ai

Убедитесь, что интеграция Cursor <> Tecton MCP работает должным образом.

Чтобы убедиться, что ваша интеграция работает так, как и ожидалось, задайте агенту курсора вопрос, подобный следующему, и убедитесь, что он правильно вызывает ваши инструменты Tecton MCP:

Запросите Индекс примеров Tecton и расскажите мне что-нибудь о BatchFeatureViews и чем они отличаются от StreamFeatureViews. Также посмотрите Справочник SDK.

Начните разработку функций с помощью искусственного интеллекта :-)

Теперь вы можете перейти в репозиторий функций в Cursor и начать использовать Co-Pilot от Tecton, напрямую интегрированный в Cursor.

Посмотрите этот Loom, чтобы узнать, как можно использовать интеграцию для создания новых функций: https://www.loom.com/share/3658f665668a41d2b0ea2355b433c616

Как использовать определенную версию Tecton SDK

По умолчанию этот инструмент предоставляет руководство для последней предварительной версии Tecton SDK. Если вам нужны инструменты для соответствия определенной выпущенной версии Tecton (например, 1.0.34 или 1.1.10 ), выполните следующие действия:

Закрепить версию в Откройте pyproject.toml и замените существующую строку зависимости

dependencies = [ # ... other dependencies ... "tecton>=0.8.0a0" ]

с точной версией, которую вы хотите, например

dependencies = [ # ... other dependencies ... "tecton==1.1.10" ]

Удалите существующий файл блокировки. Поскольку uv.lock записывает график зависимости, вы должны удалить его, чтобы uv мог разрешить новую версию Tecton:

cd <path-to-your-local-clone> rm uv.lock

Повторно сгенерируйте файл блокировки , повторно выполнив шаг 3 (команда MCP_SMOKE_TEST=1 uv --directory ) раздела «Быстрый старт» . (Это загрузит закрепленную версию в изолированную среду для MCP и заново создаст uv.lock .)
Перезапустите Cursor, чтобы новая версия Tecton загрузилась в виртуальную среду MCP.

Поддерживаемые версии: В настоящее время инструменты поддерживают Tecton ≥ 1.0.0. Примеры кода пока не версионированы – они всегда используют последнюю стабильную версию SDK – однако документация и индексы ссылок SDK теперь будут соответствовать версии, которую вы закрепили.

Поиск неисправностей

Курсор <-> Интеграция сервера Tecton MCP

Убедитесь, что Cursor показывает "tecton" как "Enabled" MCP server в "Cursor Settings -> MCP". Если вы не видите "зеленую точку", запустите MCP server в режиме диагностики (см. ниже)

Запустите MCP в режиме диагностики

Для отладки сервера Tecton MCP можно выполнить следующую команду. Замените <path-to-your-local-clone> фактическим путем, по которому вы клонировали репозиторий:

uv --directory <path-to-your-local-clone> run mcp dev src/tecton_mcp/mcp_server/server.py

Примечание: запуск сервера MCP Tecton займет несколько секунд, поскольку он загружает в память модель внедрения, которую он использует для поиска соответствующих фрагментов кода.

Подождите несколько секунд, пока stdout не сообщит вам, что MCP Inspector запущен и работает, а затем откройте его по указанному URL-адресу (что-то вроде http://localhost:5173 ).

Нажмите «Подключиться», а затем отобразите список инструментов. Вы должны увидеть инструменты Tecton MCP Server и иметь возможность запрашивать их.

Ресурсы

Лицензия

Данный проект лицензирован в соответствии с лицензией MIT .

Tecton MCP Server

Правила сервера и курсора Tecton MCP

Оглавление