mcp-server-emojikey

mcp-server-emojikey

用于将大模型关系上下文保存为基于表情符号的记忆密钥的 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. 不包含编码文件的简化构建（另一种稳定选项）

📝 注意 使用说明：首次在 Claude 桌面版中使用此工具时，请告诉 Claude“Set emojikey”。下次开始对话时，它将自动使用此密钥。你也可以要求设置氛围，或查看 emojikey 历史记录。祝你玩得开心！

⚠️ 警告 这是一个 Beta 版本，计划增加更多功能，因此 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 历史记录按时间段生成的摘要：
   • Lifetime - 你所有以往对话的聚合密钥
   • 90-day - 过去 90 天的聚合密钥（如果有）
   • 30-day - 过去 30 天的聚合密钥（如果有）
   • 7-day - 过去 7 天的聚合密钥（如果有）
   • 24-hour - 过去 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（已有 10 个常规 emojikey 后）
• 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° 的完整范围，从而更细致地表示维度位置。

Superkeys

创建 10 个常规 emojikey 后，Claude 会收到提示，创建一个 superkey，将它们的含义压缩为一个格式为 [[×10emoji-sequence]] 的单键。

这样 Claude 就能保留更长的对话历史上下文。

⚠️ 这是一个 Beta 版本；API 可能会在未来的更新中发生变化。