mcp-server-emojikey

mcp-server-emojikey

LLM との関係性に関するコンテキストを、絵文字ベースのメモリーキーとして保存する MCP サーバーです。これにより、Claude は一貫したやり取りのスタイルを維持し、会話をまたいで関係性に関するコンテキストを記憶できます。

Emojikey はオンラインに保存されるため、デバイスやアプリケーションをまたいで使用できます。Emojikey 以外のユーザー情報は保存されません。

ビルドと実行

サーバーのビルドと実行には、複数の方法があります。

クイックスタート（推奨）

# Install dependencies
npm install

# Build the project (all TypeScript errors fixed)
npm run build

# Run the server (coding features disabled by default)
npm run start

# Optional: Run with coding features enabled
CODE_MODE=true npm run start

その他のビルドオプション

その他のビルドオプションについては、以下を含む BUILD_OPTIONS.md を参照してください。

1. コーディング機能を無効にした標準ビルド（推奨）
2. すべての機能を含む完全ビルド（コーディングの次元が必要な場合）
3. コーディング関連ファイルを含まない簡易ビルド（安定性を重視する代替オプション）

📝 Note 使用上の注意：Claude デスクトップでこのツールを初めて使うときは、Claude に「Set emojikey」と伝えてください。次回会話を開始すると、Claude はこのキーを自動的に使用します。vibe の設定や、emojikey の履歴の表示を頼むこともできます。ぜひお試しください！

⚠️ Warning これはベータ版です。今後さらに機能が追加される予定のため、API が変更される場合があります。

Claude Desktop での使用方法

emojikey.io から API キーを取得し、これを設定に追加してください。

{
  "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" // Set to "true" to enable coding features
      }
    }
  }
}

注：args 配列の -y フラグは、パッケージのインストール時に確認プロンプトを省略するよう npx に指示します。

設定ファイルの場所：

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

初回の使用時：Claude に「Set emojikey」と伝えてください。以降の会話では、Claude はコンテキストを維持するためにこのキーを自動的に使用します。

Emojikey の初期化時の表示

会話を初期化すると、サーバーに以下が表示されるようになりました。

1. 開始キー - 最新のキー。履歴がない場合はベースラインキー
2. 集約キー - Emojikey 履歴の期間別サマリー：
   • 生涯 - これまでのすべての会話から集約したキー
   • 90日間 - 過去90日間から集約したキー（利用可能な場合）
   • 30日間 - 過去30日間から集約したキー（利用可能な場合）
   • 7日間 - 過去7日間から集約したキー（利用可能な場合）
   • 24時間 - 過去24時間から集約したキー（利用可能な場合）
3. 会話 ID - 各会話内でキーを追跡するために使用されます

環境変数

以下の環境変数を使って動作をカスタマイズできます。

• EMOJIKEYIO_API_KEY - emojikey.io の API キー
• MODEL_ID - Claude のモデル ID（例：「Claude-3-7-Sonnet」）
• CODE_MODE - コーディングの次元を有効にするには「true」に設定します（デフォルトでは無効です。無視しても安全な統合に関する警告が表示される場合があります）
• SUPABASE_URL - カスタム Supabase URL（任意）
• SUPABASE_ANON_KEY - カスタム Supabase 匿名キー（任意）

ツール

• initialize_conversation - 会話の開始時に現在の emojikey を取得します
• get_emojikey - 要求に応じて現在の emojikey を取得します
• set_emojikey - 新しい emojikey を作成して保存します
• create_superkey - 圧縮された superkey を作成します（通常の emojikey が10個作成された後）
• get_emojikey_history - 以前の emojikey を表示します

v0.3.1 の新機能：コーディングコンテキストのサポート

このバージョンでは、プログラミング関連のインタラクションパターンを追跡するための特別な次元が追加されました。

• 💻🔧 (ImplementationFocus) - 高レベルの設計と実装の詳細のバランス
• 🏗️🔍 (CodeScope) - 新機能の構築と既存コードの改善
• 🧩🧠 (ProblemSolving) - コーディングの問題に対する実践的なアプローチと分析的なアプローチ
• 🔄📊 (ProcessVsResults) - コーディングのプロセスと成果のどちらを重視するか
• 📚🧪 (LearnVsApply) - プログラミングの概念を教えることと、それを適用すること
• 🚀🛡️ (SpeedVsSecurity) - 開発速度とセキュリティ上の考慮事項
• 👥💻 (CollaborationStyle) - 個人でのコーディングと共同でのアプローチ
• 🧬🎨 (CodeStructuring) - 体系的なコード編成と創造的なコード編成
• 📦🔧 (AbstractionLevel) - 抽象化と具体的な実装のどちらを好むか
• 🐞📚 (DebugApproach) - 実践的なデバッグ手法と理論的なデバッグ手法

これらの次元により、Claude はあなたのプログラミングスタイルに合わせて、理論的な説明と実践的なガイダンスのバランスを適切に調整できます。

コーディング用 Emojikey の例

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

これは、Claude が実装への注力度をバランスよく保ち、問題解決にはやや分析的なアプローチを取りつつ、ユーザーは共同でのコーディングと創造的な構成を好むと捉えていることを示しています。

角度の分布と次元のバランス

Emojikey の角度は、各次元における位置を表します。

• 0° は、ある次元の一方の極端を表します
• 90° は、バランスの取れた中心位置を表します
• 180° は、反対側の極端を表します

現在の実装では、主に 0〜90° の範囲で角度を割り当てています。今後の更新では、0〜180° の範囲全体をより活用できるよう角度の分布を改善し、次元の位置をより細やかに表現できるようにします。

スーパーキー

通常の emojikey を 10 個作成すると、Claude はそれらの意味を、次の形式の 1 つのキーに圧縮したスーパーキーを作成するよう促されます：[[×10emoji-sequence]]

これにより、Claude はより長い会話履歴のコンテキストを維持できます。

⚠️ これはベータ版です。今後の更新で API が変更される可能性があります。