Tecton MCP 서버

Tecton MCP 서버 및 커서 규칙

Tecton의 Co-Pilot은 MCP 서버와 커서 규칙으로 구성됩니다. 더 자세한 내용은 이 블로그를 참조하세요.

ℹ️ 정보 : 이 가이드에서는 이 저장소를 사용하여 Tecton MCP 서버를 설정하고 Tecton으로 기능을 개발하는 동안 이를 사용하도록 기능 저장소를 구성하는 방법을 안내합니다.

빠른 시작

이 저장소를 로컬 컴퓨터에 복제하세요.지엑스피1참고: 방금 저장소를 복제한 디렉터리 경로는 다음 단계에서 <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 서버를 하위 프로세스로 생성합니다.
MCP 서버로 커서(또는 다른 MCP 클라이언트)를 구성합니다(아래 참조)
Tecton 클러스터에 로그인하세요.
tecton login yourcluster.tecton.ai
Cursor를 실행하고 Cursor에서 Tecton의 Co-Pilot을 사용하여 기능 개발을 시작하세요!

텍톤 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는 Cursor와 같은 LLM 기반 편집기와 통합되어 기능 엔지니어링을 위한 도구 기반 컨텍스트와 지원을 제공합니다.

Tecton MCP 아키텍처

Tecton MCP를 사용하여 기능을 구축하는 전반적인 흐름은 다음과 같습니다.

Tecton MCP 흐름도

커서를 사용하여 Tecton 설정

다음은 Cursor 0.48 이상에서 테스트되었습니다.

커서에서 Tecton MCP 서버 구성

커서 설정 -> MCP로 이동하여 "새 글로벌 MCP 서버 추가" 버튼을 클릭하면 커서의 mcp.json 파일이 편집됩니다. 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"
            ]
        }
    }
}

커서 규칙 추가

이 저장소의 .cursor/rules 폴더 에서 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

커서 <> Tecton MCP 통합이 예상대로 작동하는지 확인하세요.

통합이 예상대로 작동하는지 확인하려면 커서 에이전트에 다음과 같은 질문을 하고 Tecton MCP 도구를 올바르게 호출하는지 확인하세요.

Tecton의 예제 인덱스를 쿼리하여 BatchFeatureViews에 대해, 그리고 StreamFeatureViews와 어떻게 다른지 알려주세요. SDK 참조도 참고해 주세요.

AI 지원 기능 엔지니어링을 시작하세요 :-)

이제 Cursor의 Feature Repository 로 가서 Cursor에 직접 통합된 Tecton의 Co-Pilot을 사용할 수 있습니다.

이 Loom을 보고 통합을 사용하여 새로운 기능을 구축하는 방법을 확인하세요: https://www.loom.com/share/3658f665668a41d2b0ea2355b433c616

특정 Tecton SDK 버전을 사용하는 방법

기본적으로 이 도구는 Tecton SDK의 최신 사전 릴리스 버전에 대한 지침을 제공합니다. 도구를 특정 Tecton 릴리스 버전(예: 1.0.34 또는 1.1.10 )과 맞춰야 하는 경우 다음 단계를 따르세요.

pyproject.toml 에 버전을 고정합니다. pyproject.toml 열고 기존 종속성 줄을 바꿉니다.

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

원하는 정확한 버전, 예:

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

기존 잠금 파일을 제거합니다. uv.lock 종속성 그래프를 기록하므로, uv 새 Tecton 버전을 확인할 수 있도록 uv.lock을 삭제해야 합니다.

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

빠른 시작 섹션의 3단계 ( MCP_SMOKE_TEST=1 uv --directory 명령)를 다시 실행하여 잠금 파일을 다시 생성하세요 . (이렇게 하면 고정된 버전이 MCP의 격리된 환경에 다운로드되고 uv.lock 다시 생성됩니다.)
커서를 다시 시작하여 새로운 Tecton 버전이 MCP 가상 환경에 로드되도록 합니다.

지원 버전: 이 도구는 현재 Tecton ≥ 1.0.0을 지원합니다. 코드 예제는 아직 버전이 지정되지 않았으며, 항상 최신 안정형 SDK를 사용합니다. 하지만 문서 및 SDK 참조 인덱스는 이제 고정된 버전과 일치합니다.

문제 해결

커서 <-> Tecton MCP 서버 통합

커서 설정 -> MCP에서 "tecton"이 "활성화된" MCP 서버로 표시되는지 확인하세요. "녹색 점"이 표시되지 않으면 MCP 서버를 진단 모드로 실행하세요(아래 참조).

진단 모드에서 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

참고: Tecton의 MCP 서버를 실행하는 데는 몇 초가 걸립니다. 이는 관련 코드 조각을 검색하는 데 사용되는 임베딩 모델을 메모리에 로드하기 때문입니다.

MCP 검사기가 실행 중이라는 stdout 메시지가 나타날 때까지 몇 초간 기다린 다음 인쇄된 URL(예 : http://localhost:5173 )에서 액세스하세요.

"연결"을 클릭한 다음 도구 목록을 확인하세요. Tecton MCP 서버 도구가 표시되고 쿼리를 실행할 수 있습니다.

자원

특허

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여되었습니다.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

미션 컨트롤 프로토콜을 통해 Tecton 클러스터와 상호 작용하고, 기능 저장소를 관리하고, Tecton CLI 명령을 실행하는 도구 세트를 제공합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

cosense-mcp-server
yosider
-
security
F
license
-
quality
The cosense-mcp-server facilitates the integration with Claude Desktop by serving as a middleware command pipeline server, allowing for interaction with projects in cosense.
Last updated -
7
3
TypeScript
Vercel MCP Server
Quegenx
A
security
F
license
A
quality
A powerful Model Context Protocol (MCP) server enabling seamless Vercel project management, including deployments, domains, environment variables, and team configurations through Cursor's Composer or Codeium's Cascade.
Last updated -
65
17
TypeScript
tfmcp
nwiizo
-
security
A
license
-
quality
🌍 Terraform Model Context Protocol (MCP) Tool - An experimental CLI tool that enables AI assistants to manage and operate Terraform environments. Supports reading Terraform configurations, analyzing plans, applying configurations, and managing state with Claude Desktop integration. ⚡️
Last updated -
292
Rust
MIT License
Salesforce CLI MCP Server
codefriar
A
security
F
license
A
quality
Exposes Salesforce CLI functionality to LLM tools like Claude Desktop, allowing AI agents to execute Salesforce commands, manage orgs, deploy code, and query data through natural language.
Last updated -
5
72
28
JavaScript

View all related MCP servers

Tecton MCP Server