sticker-server/README.md

# Sticker MCP Server

This is an MCP (Model Context Protocol) server that allows large language models to search and send stickers based on emotion descriptions.

## Features

- Search for stickers based on emotion descriptions
- Return sticker images in response to queries
- Integrate with existing sticker search API

## Installation

1. Install dependencies:

   ```
   cd sticker-server
   npm install
   ```

2. Make the server executable:

   ```
   npm run build
   ```

3. Configure the MCP settings:

   - For Claude Desktop app: Copy the contents of `mcp_settings.json` to `~/Library/Application Support/Claude/claude_desktop_config.json`
   - For Claude VSCode extension: Copy the contents of `mcp_settings.json` to `~/Library/Application Support/Trae/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`

   If the file already exists, merge the "sticker" entry into the existing "mcpServers" object.

## Usage

Once the MCP server is configured, you can ask the language model to express emotions using stickers. For example:

- "Show me a happy sticker"
- "I'm feeling sad, can you send a sticker?"
- "Send a cat sticker"

The language model will use the `send_sticker` tool to search for and display an appropriate sticker based on your request.

## How it Works

The server connects to a local sticker search API running at `http://localhost:7860/api/search_stickers` and provides the search results to the language model, which can then display the stickers in its responses.