Identimoji MCP Server Emojikey

🚀 MCP Protocol for Persisting LLM Interaction Styles - EmojiKey Server

This server enables Large Language Models (LLMs) to maintain consistent interaction styles in conversations through "emojikeys". Emojikeys are context - based and used to store and manage the interaction patterns between LLMs and users.

Emojikeys are stored online, so they can be used across different devices and applications. No other user information is stored except for emojikeys.

If you have requirements for a local version or other features, please feel free to contact us. We are actively developing this concept.

⚠️ Important Note

Usage instructions: When using this tool in the Claude desktop version for the first time, instruct Claude to "set the emojikey". Then, the next time you start a conversation, it will automatically use this key. You can also request to display the mood or emojikey history. Have fun!

⚠️ Warning

Please note that this is a test version, and more features are under development. Therefore, the API may change.

✨ Features

EmojiKey Management

• Get the current emojikey for the user - model combination.
• Set a new emojikey during a conversation.
• Retrieve the emojikey history.
• Automatically generate and validate API keys.

Tools

• initialize_conversation - Get the current emojikey at the start of a conversation.
• get_emojikey - View the current emojikey.
• set_emojikey - Update the emojikey.
• get_emojikey_history - View previous emojikeys.

📦 Installation

1. Obtain your API key from emojikey.io.

2. Add the server configuration to the Claude desktop version:

   • On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-emojikey": {
      "command": "npx",
      "args": ["@identimoji/mcp-server-emojikey"],
      "env": {
        "EMOJIKEYIO_API_KEY": "Place your API key here", // Obtained from emojikey.io
        "MODEL_ID": "Claude-3-5-Sonnet-20241022"
      }
    }
  }
}

💻 Development

Install dependencies

npm install

Build the server

npm run build

Development with auto - rebuild

npm run watch

Test the server

npm run test

Environment Variables

• EMOJIKEYIO_API_KEY - Your emojikey.io API key.
• MODEL_ID - LLM model identifier (e.g., "Claude-3-5-Sonnet-20241022").

Debugging

Since the MCP server communicates via standard input/output, debugging can be challenging. We recommend:

1. Using the test script: npm run test
2. Using MCP Inspector:

npm run inspector