项目简介

Tecton MCP 服务器是 Tecton Co-Pilot 的一个核心组件,旨在通过 Model Context Protocol (MCP) 为大型语言模型 (LLM) 驱动的客户端(例如 Cursor 编辑器)提供丰富的上下文信息和功能。它允许 LLM 助手访问 Tecton Python SDK 的参考文档和相关的代码示例,帮助用户更高效地进行特征工程开发。

主要功能点

该服务器通过 MCP 协议提供以下核心功能:

  • 获取 Tecton SDK 参考: 提供 Tecton Python SDK 中公共类和函数的详细参考信息,包括其声明、导入路径和文档字符串。支持获取全部参考或根据特定类/函数名称进行筛选。
  • 搜索 Tecton 代码示例: 利用向量数据库,根据用户的自然语言查询查找相关的 Tecton 特征工程代码示例。这有助于用户快速了解如何实现特定的功能或模式。
  • 作为 LLM 上下文源: 将上述信息作为上下文提供给与之连接的 LLM 客户端,使 LLM 能够基于准确的 Tecton 知识回答问题、生成代码或提供建议。

安装步骤

要运行 Tecton MCP 服务器,您需要先获取仓库代码并安装依赖:

  1. 克隆仓库: 使用 Git 将本仓库克隆到您的本地机器上。

    git clone https://github.com/tecton-ai/tecton-mcp.git
    cd tecton-mcp

    记下您克隆仓库的完整路径,后续配置需要使用。您可以使用 'pwd' 命令查看当前路径。

  2. 安装 uv 包管理器: 服务器使用 'uv' 包管理器来运行。如果您尚未安装,请按照 uv 的官方文档进行安装(例如,使用 Homebrew 安装)。

    brew install uv # 示例:macOS 使用 Homebrew
  3. 验证服务器启动: 运行以下命令启动服务器一次,验证是否能正常初始化。请将 '<path-to-your-local-clone>' 替换为您在步骤 1 中记下的实际路径。

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

    如果看到类似 '{"timestamp": "...", "level": "INFO", "message": "Tecton MCP Server initialized", ...}' 的日志输出,说明服务器已成功启动并初始化。您可以按 'Ctrl+C' 退出。

服务器配置(供 MCP 客户端使用)

Tecton MCP 服务器是一个后端服务,需要由 MCP 客户端(如 Cursor 编辑器)连接和使用。在您的 MCP 客户端中配置该服务器时,通常需要提供服务器的启动命令及其参数。

例如,在 Cursor 编辑器的 MCP 设置中添加一个新的 MCP 服务器时,您需要配置以下信息:

  • 服务器名称 (server name): 为您的 MCP 服务器起一个标识名称,例如 'tecton'。
  • 命令 (command): 启动服务器的可执行文件,通常是 'uv'。
  • 参数 (args): 传递给命令的参数列表。这些参数告诉 'uv' 如何运行 Tecton MCP 服务器脚本。
    • '--directory':指定项目的根目录路径。其值应为 '<path-to-your-local-clone>',即您克隆本仓库的实际本地路径。
    • 'run':'uv' 的一个子命令,用于运行项目内的脚本。
    • 'mcp':在 'uv run' 环境下运行的脚本或模块名称。
    • 'run':传递给 MCP 脚本的参数,指示其以运行模式启动服务器。
    • 'src/tecton_mcp/mcp_server/server.py':MCP 服务器的入口脚本路径。

请根据您的 MCP 客户端界面填写上述信息,确保路径参数正确指向您本地克隆的 'tecton-mcp' 仓库位置。客户端配置完成后,它将能够启动并与该服务器建立连接。

基本使用方法

成功配置并在 MCP 客户端中连接到 Tecton MCP 服务器后,您可以通过客户端的 LLM 助手与之互动。例如,在 Cursor 中,您可以直接向助手提问,助手会调用 Tecton MCP 服务器提供的工具来获取答案。

例如,尝试询问助手:

Query Tecton's Examples Index and tell me something about BatchFeatureViews and how they differ from StreamFeatureViews. Also look at the SDK Reference.

LLM 助手收到此查询后,会识别需要 Tecton 相关信息,并调用 Tecton MCP 服务器的相应工具(例如,查询代码示例工具和获取 SDK 参考工具)。服务器执行这些工具,并将结果返回给 LLM 助手,助手再根据这些信息生成回答给您。

通过这种方式,您可以直接在开发环境中获得关于 Tecton API 使用和最佳实践的代码示例和参考信息,无需手动查找文档。

信息

分类

开发者工具