MCP Vertex Search Snippets

mcp顶点搜索片段

一个轻量级的MCP服务器，与Vertex AI Search集成，用于检索可配置的代码段和提取段，以进行文档发现。

目的

mcp顶点搜索片段允许您将顶点AI搜索作为mcp工具公开。 它提供了一个符合MCP的搜索工具，该工具接受一个查询字符串，从Vertex AI search索引的文件中返回高质量的搜索片段或提取结果。

发布

版本 mcp-vertex-search-snippets 发布在GitHub Release上。由于此MCP服务器是用Go编写的，因此每个版本都为macOS、Linux和Windows提供了预编译的可执行文件，可以随时下载和运行。

或者，如果您安装了Go，则可以使用以下命令直接从源代码安装mcp顶点搜索代码段：

go install github.com/UnitVectorY-Labs/mcp-vertex-search-snippets@latest

配置

服务器使用命令行参数、环境变量和YAML配置文件（vertex.YAML）进行配置。

命令行参数

• --vertexConfig：配置YAML文件的路径。如果已设置，则此设置优先于VERTEX_CONFIG环境变量。如果两者都没有提供，应用程序将退出并显示错误。
• --vertexDebug：如果提供，则启用stderr的详细调试日志记录，包括HTTP请求/响应转储。如果已设置，则优先于VERTEX_DEBUG环境变量。
• --http：在给定端口上以流式HTTP模式运行服务器（例如--http8080）。默认为stdio。

环境变量

• VERTEX_CONFIG：配置YAML文件的路径。如果未设置--vertexConfig，则使用。
• VERTEX_DEBUG：如果设置为true（不区分大小写），则启用详细的调试日志记录。如果未设置--vertexDebug，则使用。

vertex.yaml

vertex.yaml文件指定了发现引擎配置：

project_id: "000000000000"
location: "us"
app_id: "example_0000000000000"

属性：

• project_id：您的Google Cloud项目ID。
• location：全球、美国或欧盟。
• app_id：Discovery Engine应用程序/引擎标识符。

MCP工具

此MCP服务器公开了一个工具：

搜索

根据提供的查询搜索相关文档。

输入：

• query （字符串，必填）：搜索文本。
• maxExtractiveSegmentCount （number，可选）：要返回的提取段的最大数量（默认值：1）。

注释：

• title：“搜索”
• readOnlyHint：true
• destructiveHint错误的
• idempotentHint：true
• openWorldHint：true

在流式HTTP模式下运行

默认情况下，服务器在stdio模式下运行。要在流式HTTP模式下运行：

./mcp-vertex-search-snippets --http 8080

然后，您的MCP客户端可以连接到：

http://localhost:8080/mcp

如果授权标头传递给MCP服务器，则用于使用Vertex AI Search进行身份验证。否则，服务器将通过Google Cloud的默认身份验证链（服务帐户、gcloud CLI等）获取凭据。

局限性

• mcp顶点搜索片段的每个实例只能连接到vertex.yaml中定义的单个发现引擎实例。
• 当前仅显示搜索工具；资源不作为MCP资源公开。
• 需要通过应用程序默认凭据提供的有效Google Cloud凭据。