| # MCP resource tools |
|
|
| MCP resource tools let Gemini CLI discover and retrieve data from contextual |
| resources exposed by Model Context Protocol (MCP) servers. |
|
|
| ## 1. `list_mcp_resources` (ListMcpResources) |
|
|
| `list_mcp_resources` retrieves a list of all available resources from connected |
| MCP servers. This is primarily a discovery tool that helps the model understand |
| what external data sources are available for reference. |
|
|
| - **Tool name:** `list_mcp_resources` |
| - **Display name:** List MCP Resources |
| - **Kind:** `Search` |
| - **File:** `list-mcp-resources.ts` |
| - **Parameters:** |
| - `serverName` (string, optional): An optional filter to list resources from a |
| specific server. |
| - **Behavior:** |
| - Iterates through all connected MCP servers. |
| - Fetches the list of resources each server exposes. |
| - Formats the results into a plain-text list of URIs and descriptions. |
| - **Output (`llmContent`):** A formatted list of available resources, including |
| their URI, server name, and optional description. |
| - **Confirmation:** No. This is a read-only discovery tool. |
| |
| ## 2. `read_mcp_resource` (ReadMcpResource) |
|
|
| `read_mcp_resource` retrieves the content of a specific resource identified by |
| its URI. |
|
|
| - **Tool name:** `read_mcp_resource` |
| - **Display name:** Read MCP Resource |
| - **Kind:** `Read` |
| - **File:** `read-mcp-resource.ts` |
| - **Parameters:** |
| - `uri` (string, required): The URI of the MCP resource to read. |
| - **Behavior:** |
| - Locates the resource and its associated server by URI. |
| - Calls the server's `resources/read` method. |
| - Processes the response, extracting text or binary data. |
| - **Output (`llmContent`):** The content of the resource. For binary data, it |
| returns a placeholder indicating the data type. |
| - **Confirmation:** No. This is a read-only retrieval tool. |
|
|
