thoth.mcp.tools

Thoth MCP Tools - Tool definitions for the MCP server.

This module contains all MCP tool definitions using FastMCP decorators. Add new tools here to extend the MCP server capabilities.

Functions

get_vector_store()

Get or initialize the vector store.

list_tools()

List all available MCP tools and their descriptions.

list_topics()

List all unique topics/sections available in the handbook collection.

search_handbook(query[, num_results])

Search the GitLab Handbook for relevant content.

setup_logger(name[, level, simple, json_output])

Create and configure a logger with structured JSON output.

Classes

FastMCP([name, instructions, website_url, ...])

TransportSecuritySettings(*[, ...])

Settings for MCP transport security features.

VectorStore([persist_directory, ...])

Vector store for document embeddings using LanceDB.
thoth.mcp.tools.get_vector_store() → VectorStore[source]

Get or initialize the vector store.

thoth.mcp.tools.list_tools() → str[source]

List all available MCP tools and their descriptions.

Returns:

Formatted list of available tools with descriptions

thoth.mcp.tools.list_topics() → str[source]

List all unique topics/sections available in the handbook collection.

Returns:

Formatted list of topics with document counts

thoth.mcp.tools.search_handbook(query: str, num_results: int = 5) → str[source]

Search the GitLab Handbook for relevant content.

Parameters:

  • query – Natural language search query

  • num_results – Number of results to return (default: 5, max: 20)

Returns:

Formatted search results with relevant handbook sections