Resources implementation

[swissspidy]

Needed for editing existing media files and reading log files. We could potentially support more resources like database records or arbitrary files (e.g. to create plugins)

[tomepajk]

added the resources file on branch add_media_resources

[swissspidy]

From the documentation:

Resources are designed to be application-controlled, meaning that the client application can decide how and when they should be used. Different MCP clients may handle resources differently. For example:

• Claude Desktop currently requires users to explicitly select resources before they can be used
• Other clients might automatically select resources based on heuristics
• Some implementations may even allow the AI model itself to determine which resources to use

Server authors should be prepared to handle any of these interaction patterns when implementing resource support. In order to expose data to models automatically, server authors should use a model-controlled primitive such as Tools.

[swissspidy]

https://llmindset.co.uk/posts/2025/01/mcp-files-resources-part1/

[swissspidy]

Original implementation: #40

[swissspidy]

We could maybe do something like this...

If you write wp ai "Modify image media://1234 to remove the background", we can:

1. Do a regex check for URI schemes such as https://..., file://, or media:// in this case
2. Go through all connected MCP servers and their resource templates
3. If there is a server that has a matching media://{id} template, fetch that resource from the server
4. Attach the resource as a blob to the context for the LLM (see Update image generation/editing tool #62)
   • Probably as an Inline_Data_Part instead of File_Data_Part because the URL might not be publicly accessible (e.g. local web server)
5. Replace media://1234 in the original prompt with the image file name
   • Does that work / make sense? Or maybe don't do anything at all and the LLM figures it out by itself?

[swissspidy]

Gemini CLI uses @ to specify files for context (e.g., @src/myFile.ts) to target specific files or folders.

This could work for resources too.