emojikey-context-persistence-engine

MCP server designed to serialize Large Language Model (LLM) relational context using unique emoji sequence keys for storage. This mechanism ensures cognitive consistency and persistence of interpersonal context for models like Claude across sessions.

These "Emojikeys" are maintained on a remote infrastructure, enabling seamless context transfer between different client platforms. The system strictly isolates stored data, recording only the emojikeys themselves, with no retention of personal user identification data.

Deployment and Execution

The server can be initialized using several distinct methods:

Rapid Initialization (Recommended)

bash

Install requisite node packages

npm install

Compile source code (ensures TypeScript integrity)

npm run build

Initiate server operation (feature flags are inert by default)

npm run start

Optional: Initiate server with advanced coding modules activated

CODE_MODE=true npm run start

Alternate Compilation Strategies

For comprehensive build parameters, refer to the [BUILD_OPTIONS.md] document, which details options including:

1. Standard Build (Default Configuration, Coding Features Inactive)
2. Comprehensive Build (All Modules, Including Advanced Coding Dimensions)
3. Minimalist Build (Excluding Coding Artifacts for Maximum Stability)

📝 Operational Directive For first-time utilization within the Claude desktop client, instruct the agent to "Set emojikey." Subsequently, the agent will automatically load this context upon session commencement. Users can also request context mood adjustments or query the history of stored keys. Enjoy leveraging personalized AI interaction!

⚠️ Status Advisory This platform component is currently in a beta release cycle. Future iterations may introduce schema or interface modifications.

Integration Guide for Claude Desktop

Acquire your operational credential from [emojikey.io] and incorporate it into your configuration manifest:

{ "mcpServers": { "emojikey": { "command": "npx", "args": ["-y", "@identimoji/mcp-server-emojikey"], "env": { "EMOJIKEYIO_API_KEY": "your-api-key-from-emojikey.io", "MODEL_ID": "Claude-3-7-Sonnet", "CODE_MODE": "false" // Toggle to "true" for enabling programming analysis capabilities } } } }

Note: The -y argument supplied to npx suppresses interactive confirmation prompts during package retrieval.

Configuration File Locations: - MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%/Claude/claude_desktop_config.json

Initial Setup: Invoke Claude with the command "Set emojikey." Subsequent sessions benefit from automatic context loading via this identifier.

Context Initialization Report

Upon initiating a session, the server reports the active context breakdown:

1. Primary Identifier - The most recently active key or the default baseline if history is absent.
2. Cumulative Identifiers - Time-weighted summaries derived from historical keys:
3. Total Span - An aggregated key encompassing all prior interactions.
4. Quarterly Window - Consolidated key from the last 90 days (if data exists).
5. Monthly Window - Consolidated key from the last 30 days (if data exists).
6. Weekly Window - Consolidated key from the last 7 days (if data exists).
7. Daily Window - Consolidated key from the last 24 hours (if data exists).
8. Session Token - Unique identifier used for tracking persistence within the current dialogue sequence.

Runtime Parameters (Environment Variables)

Behavioral customization is achieved via these environmental settings:

• EMOJIKEYIO_API_KEY - Authentication token sourced from emojikey.io.
• MODEL_ID - Specification for the targeted Claude inference engine (e.g., "Claude-3-7-Sonnet").
• CODE_MODE - Boolean flag ("true" enables specialized programming context dimensions; default is "false").
• SUPABASE_URL - Optional endpoint for a user-defined Supabase backend.
• SUPABASE_ANON_KEY - Optional anonymous access token for the custom Supabase instance.

Exposed Functionalities (Tools)

• initialize_conversation - Fetches the active emojikey at session startup.
• get_emojikey - Retrieves the currently active emojikey upon explicit user request.
• set_emojikey - Generates and commits a new emojikey to the persistence store.
• create_superkey - Compresses ten sequential regular emojikeys into one high-density key.
• get_emojikey_history - Displays a ledger of previously utilized emojikeys.

Novelty in v0.3.1: Programming Attribute Tracking

This release introduces specialized vector dimensions designed to model software development interaction patterns:

• 💻🔧 (ImplementationFocus) - Ratio between architectural planning and immediate code execution.
• 🏗️🔍 (CodeScope) - Focus on novel feature introduction versus refactoring existing structures.
• 🧩🧠 (ProblemSolving) - Preference for empirical testing versus theoretical decomposition of issues.
• 🔄📊 (ProcessVsResults) - Weighting assigned to adherence to procedure versus achieved functional outcomes.
• 📚🧪 (LearnVsApply) - Tendency towards pedagogical instruction versus direct application of coding knowledge.
• 🚀🛡️ (SpeedVsSecurity) - Trade-off between rapid feature deployment and robust security auditing.
• 👥💻 (CollaborationStyle) - Preferred mode: independent contribution versus pair/ensemble programming.
• 🧬🎨 (CodeStructuring) - Approach to organization: rigid schema application versus adaptive, emergent design.
• 📦🔧 (AbstractionLevel) - Preference for highly generalized interfaces versus concrete, low-level implementations.
• 🐞📚 (DebugApproach) - Methodology for fault isolation: empirical tracing versus documentation-based root cause analysis.

These dimensions permit Claude to dynamically calibrate its response strategy, ensuring optimal alignment between theoretical depth and practical coding assistance.

Illustrative Coding Context Key

[ME|💻🔧8∠45|🧩🧠7∠60|🐞📚6∠40]~[CONTENT|🏗️🔍9∠30|📚🧪8∠65]~[YOU|👥💻7∠70|🧬🎨8∠55]

This notation indicates the server is positioned with a moderate bias toward implementation tasks and analytical reasoning, while it interprets the user's preferred style as collaborative engagement combined with structured creativity.

Angular Representation and Dimensional Centering

Emojikey angular values signify positional data along each defined axis: - 0° denotes the absolute endpoint of the first pole. - 90° denotes the exact center (neutral balance) of the dimension. - 180° denotes the absolute endpoint of the second pole.

The current iteration primarily utilizes the 0-90° segment. Future enhancements aim to expand angular mapping across the full 0-180° range to achieve finer-grained contextual distinction.

Composite Keys (Superkeys)

Upon accumulating ten distinct, sequential primary emojikeys, the system prompts the creation of a composite identifier. This superkey compresses the preceding sequence into a singular token formatted as: [[×10emoji-sequence]]

This mechanism extends the depth of contextual memory available to Claude.

⚠️ This is a pre-release iteration; the underlying service interface is subject to revision.