emojikey-server

Provides a persistent emoji-based interaction key to maintain a consistent LLM vibe across conversations.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-identimoji_mcp-server-emojikey": {
      "command": "npx",
      "args": [
        "@identimoji/mcp-server-emojikey"
      ],
      "env": {
        "MODEL_ID": "Claude-3-5-Sonnet-20241022",
        "EMOJIKEYIO_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

This MCP server lets you persist and reuse an emojikey across conversations with LLMs. By storing emoji-based context keys online, your models can maintain a consistent interaction vibe across devices and applications, without tying any personal data to your identity. Use this server to set, retrieve, and history-check emojikeys for a given user/model combination, and enjoy a more cohesive conversational style over time.

How to use

You interact with the emojikey MCP server through an MCP client that communicates via stdio. At the start of a conversation, you can initialize or fetch the current emojikey so the model responds with your chosen vibe. You can update the emojikey during a chat and browse past keys to understand how your style has evolved.

Key actions you can perform are: initialize a conversation to fetch the current emojikey, get the current emojikey, set a new emojikey, and view emojikey history. All actions happen through the MCP client interface that targets this server.

How to install

Prerequisites: you need Node.js and npm installed on your development machine. Node is required to run the MCP server commands shown here.

Obtain your API key from emojikey.io to enable the emojikey service.
Add the MCP server configuration to Claude Desktop. Find the Claude config file path for your OS and place the following JSON snippet inside the mcpServers section.

{
  "mcpServers": {
    "mcp-server-emojikey": {
      "command": "npx",
      "args": ["@identimoji/mcp-server-emojikey"],
      "env": {
        "EMOJIKEYIO_API_KEY": "your-api-key-goes-here",
        "MODEL_ID": "Claude-3-5-Sonnet-20241022"
      }
    }
  }
}

Development and testing

To work on the server locally, follow these commands to install dependencies, build, and test.

npm install

npm run build

npm run watch

npm run test

Environment variables

The server uses two environment variables shown in the example configuration.

EMOJIKEYIO_API_KEY — Your emojikey.io API key.
MODEL_ID — Identifier for the LLM model, for example "Claude-3-5-Sonnet-20241022".

Debugging

Because MCP servers communicate over stdio, use the built-in test and inspection tools to debug effectively.

npm run test

npm run inspector

Available tools

initialize_conversation

Get the current emojikey at the start of a conversation to ensure the model uses the correct vibe.

get_emojikey

Retrieve the current emojikey for the active user/model combination.

set_emojikey

Update the emojikey during a conversation to adjust the interaction vibe.

get_emojikey_history

View the history of previously used emojikeys for reference.