Material Image Search MCP Server

A simple Model Context Protocol (MCP) server that uses the E-Youliao Liaoyuan Material Library for image search. This server enables AI models and tools to generate relevant material images based on user prompts.

Tools

The service implements a tool called search_images.

The tool accepts the following parameters:

• description: The description of the image.
• topN: The number of most relevant images returned by the API.

Usage

You can configure the meme generator server in the client using the @xishan/material-search NPM package. Here is an example configuration for Claude Desktop (Settings -> Developer -> Edit Configuration):

{
  "mcpServers": {
    "meme": {
      "command": "npx",
      "args": ["-y", "@xishan/material-search"],
      "env": {
        "API_KEY": "your api key",
      }
    }
  }
}

Note: You need to first follow the official WeChat account "易有料燎原" send the message "素材搜索" to obtain the API_KEY.

Troubleshooting

Sometimes Claude Desktop cannot find the correct npx> version (especially if you are using NVM; see this issue for details). In this case, you can manually install material-search globally and then use it directly.

npm install -g @xishan/material-search

You can run which node in the terminal to find the path to your node executable. After that, your configuration should look like this:

{
  "mcpServers": {
    "meme": {
      "command": "/Users/<USERNAME>/.nvm/versions/node/v20.18.2/bin/node",
      "args": ["/Users/<USERNAME>/.nvm/versions/node/v20.18.2/lib/node_modules/@xishan/material-search/dist/index.js"],
      "env": {
        "API_KEY": "your api key",
      }
    }
  }
}

Example

After configuring Claude Desktop, you need to restart it. Then you will see a small hammer icon in the lower-right corner of the chat input box. You can then ask Claude to generate a meme for you.

Author

This project was developed by YiYouLiao Company.