Directories
ΒΆ
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
help
command
Package main is the entry point for the ToolHive CLI Doc Generator.
|
Package main is the entry point for the ToolHive CLI Doc Generator. |
|
regup
command
Package main is the entry point for the regup command
|
Package main is the entry point for the regup command |
|
regup/app
Package app provides the entry point for the regup command-line application.
|
Package app provides the entry point for the regup command-line application. |
|
thv
command
Package main is the entry point for the ToolHive CLI.
|
Package main is the entry point for the ToolHive CLI. |
|
thv-operator
command
Package main is the entry point for the ToolHive Kubernetes Operator.
|
Package main is the entry point for the ToolHive Kubernetes Operator. |
|
thv-operator/api/v1alpha1
Package v1alpha1 contains API Schema definitions for the toolhive v1alpha1 API group +kubebuilder:object:generate=true +groupName=toolhive.stacklok.dev
|
Package v1alpha1 contains API Schema definitions for the toolhive v1alpha1 API group +kubebuilder:object:generate=true +groupName=toolhive.stacklok.dev |
|
thv-operator/controllers
Package controllers contains the reconciliation logic for the MCPRemoteProxy custom resource.
|
Package controllers contains the reconciliation logic for the MCPRemoteProxy custom resource. |
|
thv-operator/pkg/controllerutil
Package controllerutil provides utility functions for the ToolHive Kubernetes operator controllers.
|
Package controllerutil provides utility functions for the ToolHive Kubernetes operator controllers. |
|
thv-operator/pkg/git
Package git provides Git repository operations for MCPRegistry sources.
|
Package git provides Git repository operations for MCPRegistry sources. |
|
thv-operator/pkg/httpclient
Package httpclient provides HTTP client functionality for API operations
|
Package httpclient provides HTTP client functionality for API operations |
|
thv-operator/pkg/mcpregistrystatus
Package mcpregistrystatus provides status management and batched updates for MCPRegistry resources.
|
Package mcpregistrystatus provides status management and batched updates for MCPRegistry resources. |
|
thv-operator/pkg/mcpregistrystatus/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
thv-operator/pkg/oidc
Package oidc provides utilities for resolving OIDC configuration from various sources including Kubernetes service accounts, ConfigMaps, and inline configurations.
|
Package oidc provides utilities for resolving OIDC configuration from various sources including Kubernetes service accounts, ConfigMaps, and inline configurations. |
|
thv-operator/pkg/registryapi
Package registryapi provides deployment management for the registry API component.
|
Package registryapi provides deployment management for the registry API component. |
|
thv-operator/pkg/registryapi/config
Package config provides management for the registry server config ConfigMap
|
Package config provides management for the registry server config ConfigMap |
|
thv-operator/pkg/registryapi/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
thv-operator/pkg/runconfig
Package runconfig provides functions to build RunConfigBuilder options for audit configuration.
|
Package runconfig provides functions to build RunConfigBuilder options for audit configuration. |
|
thv-operator/pkg/runconfig/configmap
Package configmap provides management for RunConfig ConfigMaps
|
Package configmap provides management for RunConfig ConfigMaps |
|
thv-operator/pkg/runconfig/configmap/checksum
Package checksum provides checksum computation and comparison for ConfigMaps
|
Package checksum provides checksum computation and comparison for ConfigMaps |
|
thv-operator/pkg/validation
Package validation provides image validation functionality for the ToolHive operator.
|
Package validation provides image validation functionality for the ToolHive operator. |
|
thv-operator/pkg/virtualmcpserverstatus
Package virtualmcpserverstatus provides status management and batched updates for VirtualMCPServer resources.
|
Package virtualmcpserverstatus provides status management and batched updates for VirtualMCPServer resources. |
|
thv-operator/pkg/virtualmcpserverstatus/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
thv-operator/pkg/vmcpconfig
Package vmcpconfig provides conversion logic from VirtualMCPServer CRD to vmcp Config
|
Package vmcpconfig provides conversion logic from VirtualMCPServer CRD to vmcp Config |
|
thv-operator/test-integration/mcp-registry
Package operator_test provides end-to-end tests for the ToolHive operator controllers.
|
Package operator_test provides end-to-end tests for the ToolHive operator controllers. |
|
thv-proxyrunner
command
Package main is the entry point for the ToolHive ProxyRunner.
|
Package main is the entry point for the ToolHive ProxyRunner. |
|
thv-proxyrunner/app
Package app provides the entry point for the toolhive command-line application.
|
Package app provides the entry point for the toolhive command-line application. |
|
thv/app
Package app provides the entry point for the toolhive command-line application.
|
Package app provides the entry point for the toolhive command-line application. |
|
thv/app/inspector
Package inspector contains definitions for the inspector command.
|
Package inspector contains definitions for the inspector command. |
|
thv/app/ui
Package ui provides terminal UI helpers for the ToolHive CLI.
|
Package ui provides terminal UI helpers for the ToolHive CLI. |
|
vmcp
command
Package main is the entry point for the Virtual MCP Server (vmcp).
|
Package main is the entry point for the Virtual MCP Server (vmcp). |
|
vmcp/app
Package app provides the entry point for the vmcp command-line application.
|
Package app provides the entry point for the vmcp command-line application. |
|
docs
|
|
|
pkg
|
|
|
api
Package api contains the REST API for ToolHive.
|
Package api contains the REST API for ToolHive. |
|
api/v1
Package v1 contains the V1 API for ToolHive.
|
Package v1 contains the V1 API for ToolHive. |
|
audit
Package audit provides audit logging functionality for ToolHive.
|
Package audit provides audit logging functionality for ToolHive. |
|
auth
Package auth provides authentication and authorization utilities.
|
Package auth provides authentication and authorization utilities. |
|
auth/discovery
Package discovery provides authentication discovery utilities for detecting authentication requirements from remote servers.
|
Package discovery provides authentication discovery utilities for detecting authentication requirements from remote servers. |
|
auth/oauth
Package oauth provides OAuth 2.0 and OIDC authentication functionality.
|
Package oauth provides OAuth 2.0 and OIDC authentication functionality. |
|
auth/remote
Package remote provides authentication handling for remote MCP servers.
|
Package remote provides authentication handling for remote MCP servers. |
|
auth/tokenexchange
Package tokenexchange provides OAuth 2.0 Token Exchange (RFC 8693) support.
|
Package tokenexchange provides OAuth 2.0 Token Exchange (RFC 8693) support. |
|
authz
Package authz provides authorization utilities using Cedar policies.
|
Package authz provides authorization utilities using Cedar policies. |
|
certs
Package certs provides utilities for certificate validation and handling.
|
Package certs provides utilities for certificate validation and handling. |
|
cli
Package cli provides utility functions specific to the CLI that we want to test more thoroughly.
|
Package cli provides utility functions specific to the CLI that we want to test more thoroughly. |
|
client
Package client provides utilities for managing client configurations and interacting with MCP servers.
|
Package client provides utilities for managing client configurations and interacting with MCP servers. |
|
client/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
config
Package config contains the definition of the application config structure and logic required to load and update it.
|
Package config contains the definition of the application config structure and logic required to load and update it. |
|
config/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
container
Package container provides utilities for managing containers, including creating, starting, stopping, and monitoring containers.
|
Package container provides utilities for managing containers, including creating, starting, stopping, and monitoring containers. |
|
container/docker
Package docker provides Docker-specific implementation of container runtime, including creating, starting, stopping, and monitoring containers.
|
Package docker provides Docker-specific implementation of container runtime, including creating, starting, stopping, and monitoring containers. |
|
container/docker/sdk
Package sdk provides a factory method for creating a Docker client.
|
Package sdk provides a factory method for creating a Docker client. |
|
container/images
Package images handles container image management operations.
|
Package images handles container image management operations. |
|
container/kubernetes
Package kubernetes provides a client for the Kubernetes runtime including creating, starting, stopping, and retrieving container information.
|
Package kubernetes provides a client for the Kubernetes runtime including creating, starting, stopping, and retrieving container information. |
|
container/kubernetes/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
container/runtime
Package runtime provides interfaces and types for container runtimes, including creating, starting, stopping, and monitoring containers.
|
Package runtime provides interfaces and types for container runtimes, including creating, starting, stopping, and monitoring containers. |
|
container/runtime/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
container/templates
Package templates provides utilities for generating Dockerfile templates based on different transport types (uvx, npx).
|
Package templates provides utilities for generating Dockerfile templates based on different transport types (uvx, npx). |
|
container/verifier
Package verifier provides a client for verifying artifacts using sigstore
|
Package verifier provides a client for verifying artifacts using sigstore |
|
core
Package core provides the core domain model for the ToolHive system.
|
Package core provides the core domain model for the ToolHive system. |
|
env
Package env provides abstractions for environment variable access to enable dependency injection and testing isolation.
|
Package env provides abstractions for environment variable access to enable dependency injection and testing isolation. |
|
env/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
environment
Package environment provides utilities for handling environment variables and environment-related operations for containers.
|
Package environment provides utilities for handling environment variables and environment-related operations for containers. |
|
errors
Package errors provides error types and utilities for the toolhive application.
|
Package errors provides error types and utilities for the toolhive application. |
|
export
Package export provides functionality for exporting ToolHive configurations to various formats.
|
Package export provides functionality for exporting ToolHive configurations to various formats. |
|
groups
Package groups provides functionality for managing logical groupings of MCP servers.
|
Package groups provides functionality for managing logical groupings of MCP servers. |
|
groups/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
healthcheck
Package healthcheck provides common healthcheck functionality for ToolHive proxies.
|
Package healthcheck provides common healthcheck functionality for ToolHive proxies. |
|
ignore
Package ignore provides functionality for processing .thvignore files to filter bind mount contents using tmpfs overlays.
|
Package ignore provides functionality for processing .thvignore files to filter bind mount contents using tmpfs overlays. |
|
k8s
Package k8s provides common Kubernetes utilities for creating clients, configs, and namespace detection that can be shared across packages.
|
Package k8s provides common Kubernetes utilities for creating clients, configs, and namespace detection that can be shared across packages. |
|
labels
Package labels provides utilities for managing container labels used by the toolhive application.
|
Package labels provides utilities for managing container labels used by the toolhive application. |
|
lockfile
Package lockfile provides utilities for managing file locks and cleanup.
|
Package lockfile provides utilities for managing file locks and cleanup. |
|
logger
Package logger provides a logging capability for toolhive for running locally as a CLI and in Kubernetes
|
Package logger provides a logging capability for toolhive for running locally as a CLI and in Kubernetes |
|
mcp
Package mcp provides MCP (Model Context Protocol) parsing utilities and middleware.
|
Package mcp provides MCP (Model Context Protocol) parsing utilities and middleware. |
|
mcp/server
Package server provides the MCP (Model Context Protocol) server implementation for ToolHive.
|
Package server provides the MCP (Model Context Protocol) server implementation for ToolHive. |
|
migration
Package migration handles any migrations needed to maintain compatibility
|
Package migration handles any migrations needed to maintain compatibility |
|
networking
Package networking provides utilities for network operations, such as finding available ports and checking network connectivity.
|
Package networking provides utilities for network operations, such as finding available ports and checking network connectivity. |
|
operator/accessors
Package accessors provides accessor functions for the ToolHive operator
|
Package accessors provides accessor functions for the ToolHive operator |
|
operator/telemetry
Package telemetry provides telemetry functionality for the ToolHive operator.
|
Package telemetry provides telemetry functionality for the ToolHive operator. |
|
permissions
Package permissions provides utilities for managing container permissions and permission profiles for the toolhive application.
|
Package permissions provides utilities for managing container permissions and permission profiles for the toolhive application. |
|
process
Package process provides utilities for managing process-related operations, such as PID file handling and process management.
|
Package process provides utilities for managing process-related operations, such as PID file handling and process management. |
|
registry
Package registry provides MCP server registry management functionality.
|
Package registry provides MCP server registry management functionality. |
|
registry/api
Package api provides client functionality for interacting with MCP Registry API endpoints
|
Package api provides client functionality for interacting with MCP Registry API endpoints |
|
registry/converters
Package converters provides bidirectional conversion between toolhive registry formats and the upstream MCP (Model Context Protocol) ServerJSON format.
|
Package converters provides bidirectional conversion between toolhive registry formats and the upstream MCP (Model Context Protocol) ServerJSON format. |
|
registry/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
registry/registry
Package registry contains the core type definitions for the MCP registry system.
|
Package registry contains the core type definitions for the MCP registry system. |
|
runner
Package runner provides functionality for running MCP servers
|
Package runner provides functionality for running MCP servers |
|
runner/retriever
Package retriever contains logic for fetching or building MCP servers.
|
Package retriever contains logic for fetching or building MCP servers. |
|
runtime
Package runtime provides workload deployment setup functionality that was previously part of the transport package.
|
Package runtime provides workload deployment setup functionality that was previously part of the transport package. |
|
secrets
Package secrets contains the secrets management logic for ToolHive.
|
Package secrets contains the secrets management logic for ToolHive. |
|
secrets/aes
Package aes contains functions for encrypting and decrypting data using AES-GCM
|
Package aes contains functions for encrypting and decrypting data using AES-GCM |
|
secrets/clients
Package clients contains code for connecting to secret provider APIs.
|
Package clients contains code for connecting to secret provider APIs. |
|
secrets/clients/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
secrets/keyring
Package keyring provides a composite keyring provider that supports multiple backends.
|
Package keyring provides a composite keyring provider that supports multiple backends. |
|
secrets/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
state
Package state provides functionality for storing and retrieving runner state across different environments (local filesystem, Kubernetes, etc.)
|
Package state provides functionality for storing and retrieving runner state across different environments (local filesystem, Kubernetes, etc.) |
|
state/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
telemetry
Package telemetry provides OpenTelemetry instrumentation for ToolHive MCP server proxies.
|
Package telemetry provides OpenTelemetry instrumentation for ToolHive MCP server proxies. |
|
telemetry/providers
Package providers contains telemetry provider implementations and builder logic
|
Package providers contains telemetry provider implementations and builder logic |
|
telemetry/providers/otlp
Package otlp provides OpenTelemetry Protocol (OTLP) provider implementations
|
Package otlp provides OpenTelemetry Protocol (OTLP) provider implementations |
|
telemetry/providers/prometheus
Package prometheus provides Prometheus metric exporter implementation
|
Package prometheus provides Prometheus metric exporter implementation |
|
transport
Package transport provides utilities for handling different transport modes for communication between the client and MCP server.
|
Package transport provides utilities for handling different transport modes for communication between the client and MCP server. |
|
transport/errors
Package errors provides error types and constants for the transport package.
|
Package errors provides error types and constants for the transport package. |
|
transport/middleware
Package middleware provides middleware functions for the transport package.
|
Package middleware provides middleware functions for the transport package. |
|
transport/proxy/httpsse
Package httpsse provides an HTTP proxy implementation for Server-Sent Events (SSE) used in communication between the client and MCP server.
|
Package httpsse provides an HTTP proxy implementation for Server-Sent Events (SSE) used in communication between the client and MCP server. |
|
transport/proxy/streamable
Package streamable provides a streamable HTTP proxy for MCP servers.
|
Package streamable provides a streamable HTTP proxy for MCP servers. |
|
transport/proxy/transparent
Package transparent provides MCP ping functionality for transparent proxies.
|
Package transparent provides MCP ping functionality for transparent proxies. |
|
transport/session
Package session provides a session manager with TTL cleanup.
|
Package session provides a session manager with TTL cleanup. |
|
transport/ssecommon
Package ssecommon provides common types and utilities for Server-Sent Events (SSE) used in communication between the client and MCP server.
|
Package ssecommon provides common types and utilities for Server-Sent Events (SSE) used in communication between the client and MCP server. |
|
transport/streamable
Package streamable provides common types and utilities for Streamable HTTP connections used in communication between the client and MCP server.
|
Package streamable provides common types and utilities for Streamable HTTP connections used in communication between the client and MCP server. |
|
transport/tunnel/ngrok
Package ngrok provides an implementation of the TunnelProvider interface using ngrok.
|
Package ngrok provides an implementation of the TunnelProvider interface using ngrok. |
|
transport/types
Package types provides common types and interfaces for the transport package used in communication between the client and MCP server.
|
Package types provides common types and interfaces for the transport package used in communication between the client and MCP server. |
|
transport/types/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
updates
Package updates contains logic for checking if an update is available for ToolHive.
|
Package updates contains logic for checking if an update is available for ToolHive. |
|
usagemetrics
Package usagemetrics provides internal usage metrics for tracking usage and adoption.
|
Package usagemetrics provides internal usage metrics for tracking usage and adoption. |
|
validation
Package validation provides functions for validating input data.
|
Package validation provides functions for validating input data. |
|
versions
Package versions provides version information for the ToolHive application.
|
Package versions provides version information for the ToolHive application. |
|
vmcp
Package vmcp provides the Virtual MCP Server implementation.
|
Package vmcp provides the Virtual MCP Server implementation. |
|
vmcp/aggregator
Package aggregator provides capability aggregation for Virtual MCP Server.
|
Package aggregator provides capability aggregation for Virtual MCP Server. |
|
vmcp/aggregator/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
vmcp/auth
Package auth provides authentication for Virtual MCP Server.
|
Package auth provides authentication for Virtual MCP Server. |
|
vmcp/auth/factory
Package factory provides factory functions for creating vMCP authentication components.
|
Package factory provides factory functions for creating vMCP authentication components. |
|
vmcp/auth/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
vmcp/auth/strategies
Package strategies provides authentication strategy implementations for Virtual MCP Server.
|
Package strategies provides authentication strategy implementations for Virtual MCP Server. |
|
vmcp/cache
Package cache provides token caching interfaces for Virtual MCP Server.
|
Package cache provides token caching interfaces for Virtual MCP Server. |
|
vmcp/client
Package client provides MCP protocol client implementation for communicating with backend servers.
|
Package client provides MCP protocol client implementation for communicating with backend servers. |
|
vmcp/client/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
vmcp/composer
Package composer provides composite tool workflow execution for Virtual MCP Server.
|
Package composer provides composite tool workflow execution for Virtual MCP Server. |
|
vmcp/composer/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
vmcp/config
Package config provides the configuration model for Virtual MCP Server.
|
Package config provides the configuration model for Virtual MCP Server. |
|
vmcp/discovery
Package discovery provides lazy per-user capability discovery for vMCP servers.
|
Package discovery provides lazy per-user capability discovery for vMCP servers. |
|
vmcp/discovery/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
vmcp/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
vmcp/router
Package router provides request routing for Virtual MCP Server.
|
Package router provides request routing for Virtual MCP Server. |
|
vmcp/router/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
vmcp/server
Package server implements the Virtual MCP Server that aggregates multiple backend MCP servers into a unified interface.
|
Package server implements the Virtual MCP Server that aggregates multiple backend MCP servers into a unified interface. |
|
vmcp/server/adapter
Package adapter provides a layer between aggregator and SDK.
|
Package adapter provides a layer between aggregator and SDK. |
|
vmcp/server/adapter/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
vmcp/session
Package session provides vMCP-specific session types that extend transport sessions with domain logic.
|
Package session provides vMCP-specific session types that extend transport sessions with domain logic. |
|
vmcp/workloads
Package workloads provides the WorkloadDiscoverer interface for discovering backend workloads in both CLI and Kubernetes environments.
|
Package workloads provides the WorkloadDiscoverer interface for discovering backend workloads in both CLI and Kubernetes environments. |
|
vmcp/workloads/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
workloads
Package workloads contains high-level logic for managing the lifecycle of ToolHive-managed containers.
|
Package workloads contains high-level logic for managing the lifecycle of ToolHive-managed containers. |
|
workloads/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
workloads/statuses
Package statuses provides an interface and implementation for managing workload statuses.
|
Package statuses provides an interface and implementation for managing workload statuses. |
|
workloads/statuses/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
workloads/types
Package types contains types and validation functions for workloads in ToolHive.
|
Package types contains types and validation functions for workloads in ToolHive. |
|
test
|
|
|
e2e
Package e2e provides end-to-end testing utilities for ToolHive.
|
Package e2e provides end-to-end testing utilities for ToolHive. |
|
integration/vmcp/helpers
Package helpers provides test utilities for vMCP integration tests.
|
Package helpers provides test utilities for vMCP integration tests. |
|
testkit
Package testkit provides testing utilities for ToolHive.
|
Package testkit provides testing utilities for ToolHive. |
Click to show internal directories.
Click to hide internal directories.