Files
Pietro Zullo e6ba394ec7 chore: format adapter files for ruff 0.15 + remove docs PR comment spam (#1003)
- Format 3 adapter files to match ruff 0.15 (CI version)
- Remove the PR comment step from docs.yml that spammed every push
2026-02-14 18:53:20 -08:00

106 lines
4.3 KiB
Python

import re
from collections.abc import Callable, Coroutine
from typing import Any
from mcp.types import Prompt, Resource, Tool
from mcp_use.agents.adapters.base import BaseAdapter
from mcp_use.client.connectors.base import BaseConnector
try:
from google.genai import types # type: ignore
except ImportError as e:
raise ImportError(
"google-genai is required for GoogleMCPAdapter. Install it with: uv pip install google-genai"
) from e
def _sanitize_for_tool_name(name: str) -> str:
"""Sanitizes a string to be a valid tool name for Google."""
# Google tool names can only contain a-z, A-Z, 0-9, and underscores,
# and must be 64 characters or less.
return re.sub(r"[^a-zA-Z0-9_]+", "_", name).strip("_")[:64]
class GoogleMCPAdapter(BaseAdapter[types.FunctionDeclaration]):
framework: str = "google"
def __init__(self, disallowed_tools: list[str] | None = None) -> None:
"""Initialize a new Google adapter.
Args:
disallowed_tools: list of tool names that should not be available.
"""
super().__init__(disallowed_tools=disallowed_tools)
# This map stores the actual async function to call for each tool.
self.tool_executors: dict[str, Callable[..., Coroutine[Any, Any, Any]]] = {}
self._connector_tool_map: dict[BaseConnector, list[types.FunctionDeclaration]] = {}
self._connector_resource_map: dict[BaseConnector, list[types.FunctionDeclaration]] = {}
self._connector_prompt_map: dict[BaseConnector, list[types.FunctionDeclaration]] = {}
self.tools: list[types.FunctionDeclaration] = []
self.resources: list[types.FunctionDeclaration] = []
self.prompts: list[types.FunctionDeclaration] = []
def _convert_tool(self, mcp_tool: Tool, connector: BaseConnector) -> types.FunctionDeclaration:
"""Convert an MCP tool to the Google tool format."""
if mcp_tool.name in self.disallowed_tools:
return None
self.tool_executors[mcp_tool.name] = lambda connector=connector, name=mcp_tool.name, **kwargs: (
connector.call_tool(name, kwargs)
)
fixed_schema = self.fix_schema(mcp_tool.inputSchema)
function_declaration = types.FunctionDeclaration(
name=mcp_tool.name, description=mcp_tool.description, parameters_json_schema=fixed_schema
)
return function_declaration
def _convert_resource(self, mcp_resource: Resource, connector: BaseConnector) -> types.FunctionDeclaration:
"""Convert an MCP resource to a readable tool in Google format."""
tool_name = _sanitize_for_tool_name(f"resource_{mcp_resource.name}")
if tool_name in self.disallowed_tools:
return None
self.tool_executors[tool_name] = lambda connector=connector, uri=mcp_resource.uri, **kwargs: (
connector.read_resource(uri)
)
function_declaration = types.FunctionDeclaration(
name=tool_name,
description=mcp_resource.description,
parameters_json_schema={"input_schema": {"type": "object", "properties": {}}},
)
return function_declaration
def _convert_prompt(self, mcp_prompt: Prompt, connector: BaseConnector) -> types.FunctionDeclaration | None:
"""Convert an MCP prompt to a usable tool in Google format."""
if mcp_prompt.name in self.disallowed_tools:
return None
self.tool_executors[mcp_prompt.name] = lambda connector=connector, name=mcp_prompt.name, **kwargs: (
connector.get_prompt(name, kwargs)
)
properties = {}
required_args = []
if mcp_prompt.arguments:
for arg in mcp_prompt.arguments:
prop = {"type": "string"}
if arg.description:
prop["description"] = arg.description
properties[arg.name] = prop
if arg.required:
required_args.append(arg.name)
parameters_schema = {"type": "object", "properties": properties}
if required_args:
parameters_schema["required"] = required_args
function_declaration = types.FunctionDeclaration(
name=mcp_prompt.name, description=mcp_prompt.description, parameters_json_schema=parameters_schema
)
return function_declaration