使用说明

Tecton MCP服务器和游标规则

Tecton的Co-Pilot由用于MCP客户端（如Cursor和Claude Code）的MCP服务器规则组成。阅读下面的文章博客学习更多。

ℹ️ 信息：本指南将引导您使用以下工具设置Tecton MCP服务器 此存储库 并配置您的 特征存储库 在使用Tecton开发功能时使用它。

Tecton MCP工具

Tecton MCP服务器公开了以下可供MCP客户端使用的工具，如Cursor或Claude Code：

工具名称	描述
`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组件的有针对性的信息。
`query_tecton_metrics_tool`	查询Tecton Metrics API。以人类可读或原始OpenMetrics格式返回时间点系统指标。

ℹ️ 基于API的工具：如果MCP服务器配置了 TECTON_API_KEY 环境变量，MCP服务器将注册其他基于API的工具，包括Tecton Feature Services和Metrics API工具。这使得代理可以从批处理、流式和实时数据源查询在线功能服务以获取新功能，并访问系统指标。

先决条件

安装 uv 包管理器：
```
brew install uv
```

快速开始

将此存储库克隆到本地计算机：
```
git clone https://github.com/tecton-ai/tecton-mcp.git
cd tecton-mcp
pwd
```
注：您刚刚克隆存储库的目录将被称为 <path-to-local-clone> 在以下步骤中。
通过运行以下命令验证您的安装。
```
MCP_SMOKE_TEST=1 uv --directory <path-to-local-clone> run mcp run src/tecton_mcp/mcp_server/server.py
```
该命令应无任何错误地退出，并打印类似以下内容的消息 MCP_SMOKE_TEST is set. Exiting after initialization.。这确认了您的本地设置工作正常——Cursor将在需要时自动将MCP服务器作为子进程生成。
登录您的Tecton集群，对Tecton MCP服务器使用的TectonSDK进行身份验证：
```
tecton login yourcluster.tecton.ai
```
使用MCP服务器配置Cursor（或任何其他MCP客户端）（见下文）

使用光标设置Tecton MCP
使用Claude代码设置Tecton MCP

启动人工智能辅助特征工程：-）

现在你可以去你的 功能库 在Cursor中，开始使用Tecton的Co-Pilot——直接集成到Cursor。

查看此Loom，了解如何使用集成来构建新功能：https://www.loom.com/share/3658f665668a41d2b0ea2355b433c616

使用光标设置Tecton MCP

以下内容使用Cursor 0.48及以上版本进行测试

在Cursor中配置Tecton MCP服务器

导航到光标设置->MCP工具，然后单击“添加自定义MCP服务器”按钮，这将打开光标的 mcp.json 文件。将以下配置添加到此文件中。确保修改了路径 <path-to-local-clone> 要匹配克隆存储库的目录，请执行以下操作：

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

添加Tecton特定的游标规则

将此存储库中的cursorules进行符号链接 . cursor/rules 文件夹进入你的特征存储库。使用符号链接可确保对原始规则的任何更新都会自动在您的功能存储库中获取：

# Symlink the entire .cursor directory in your feature repo
ln -s <path-to-local-clone>/.cursor <path-to-tecton-feature-repo>/.cursor

验证Cursor<>Tecton MCP集成是否按预期工作

为确保您的集成按预期工作，请向Cursor Agent提出以下问题，并确保它正确调用了您的Tecton MCP工具：

查询Tecton的示例索引，告诉我一些关于BatchFeatureView的信息，以及它们与StreamFeatureView的区别。另请参阅SDK参考。

如果没有调用Tecton MCP工具，您可能需要重新启动Cursor或重新加载Cursor窗口，以确保新工具正确注册。

使用Claude代码设置Tecton MCP

导航到您的Tecton功能分区并运行以下命令。

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

您应该看到以下消息：

Added stdio MCP server tecton-mcp2 to local config

接下来，开始 claude 然后跑 /mcp 确保 tecton-mcp 已连接。

claude "/mcp"

您应该看到以下内容：

tecton-mcp  ✔ connected · Enter to view details

添加Tecton特定 `CLAUDE.md` 规则

Tecton推荐的Symlink CLAUDE.md 进入你的特征存储库。使用符号链接可确保对原始规则的任何更新都会自动在您的功能存储库中获取：

ln -s <path-to-local-clone>/CLAUDE.md <path-to-tecton-feature-repo>/CLAUDE.md

使用增强功能设置Tecton MCP

您可以将Tecton的MCP服务器连接到Augment，以实现针对Tecton内部代码库的智能完成和响应。

先决条件

您已在本地克隆了此存储库。
您安装了带有增强功能的IDE（例如PyChamrm、VSCode）
您正在使用Augment的最新版本

配置

导航到增强->设置->工具->MCP->从JSON导入，并导入以下配置（更新 <path-to-local-clone> 指向克隆此存储库的路径）：

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

您应该看到MCP服务器出现在Augment MCP设置中。

验证您的连接

重新启动IDE。
在八月询问Tecton的具体问题
您应该看到Tecton的MCP服务器的完成和响应。

建筑

Tecton MCP与Cursor等LLM驱动的编辑器集成，为功能工程提供基于工具的上下文和帮助：

Tecton MCP建筑功能的总体流程如下：

如何更新Tecton MCP服务器

要将Tecton MCP服务器更新到最新版本：

拉取最新更改 从存储库中：
```
cd <path-to-local-clone>
git pull
```
关闭并重新启动Cursor 以确保加载更新的MCP服务器。

就是这样！MCP服务器作为Cursor生成的子进程运行，因此没有持久的后台服务可以手动停止或重新启动。Cursor将在下次需要与MCP服务器通信时自动使用更新的代码。

如何使用特定的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版本：

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

重新生成锁文件 通过重新运行 第二步 （the MCP_SMOKE_TEST=1 uv --directory 命令）快速开始部分。（这将把固定版本下载到MCP的隔离环境中，并重新创建 uv.lock.)
重启光标，以便将新的Tecton版本加载到MCP虚拟环境中。

支持的版本： 这些工具目前支持Tecton≥1.0.0。代码示例尚未进行版本控制，它们始终使用最新版本 稳定的 SDK–但是，文档和SDK参考索引现在将与您固定的版本相匹配。

故障排除

Cursor<->泰克通MCP服务器集成

确保Cursor在“Cursor Settings->MCP”中显示“tecton”为“Enabled”MCP服务器。如果您没有看到“绿点”，请在诊断模式下运行MCP服务器（见下文）

在诊断模式下运行MCP

要调试Tecton MCP服务器，可以运行以下命令。替换 <path-to-local-clone> 使用克隆存储库的实际路径：

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

注意：启动Tecton的MCP服务器需要几秒钟的时间，因为它正在将一个嵌入模型加载到内存中，用于搜索相关的代码片段。

等待几秒钟，直到stdout告诉MCP Inspector已启动并正在运行，然后在打印的URL（类似于http://localhost:5173)

单击“连接”，然后列出工具。您应该看到Tecton MCP Server工具并能够查询它们。

资源

许可证

该项目根据 MIT许可证.

使用说明

Tecton MCP服务器和游标规则

目录

Tecton MCP工具

先决条件

快速开始

使用光标设置Tecton MCP

在Cursor中配置Tecton MCP服务器

添加Tecton特定的游标规则

验证Cursor<>Tecton MCP集成是否按预期工作

使用Claude代码设置Tecton MCP

添加Tecton特定 CLAUDE.md 规则

使用增强功能设置Tecton MCP

先决条件

配置

验证您的连接

推荐LLM

建筑

如何更新Tecton MCP服务器

如何使用特定的Tecton SDK版本

故障排除

Cursor<->泰克通MCP服务器集成

在诊断模式下运行MCP

资源

许可证

相关 MCP

代码索引分析工具

漏洞扫描服务

JADX APK逆向分析MCP插件

规范工作流管理工具

代码库打包工具

AI编码记忆系统

添加Tecton特定 `CLAUDE.md` 规则