ClueoMCP：为大型语言模型（LLM）添加人格特质的工具

ClueoMCP是一个开源工具，它的核心功能是为大型语言模型（LLM）注入预设的人格特质。该工具作为一个服务器运行，遵循模型上下文协议（MCP），这个协议旨在标准化AI应用与外部工具及数据的连接方式。简单来说，ClueoMCP就像一个位于AI应用和AI模型之间的“人格层”。当用户与一个兼容MCP协议的AI助手（例如某些桌面AI应用）互动时，ClueoMCP可以拦截并调整指令，让AI的每一次回应都带有一种稳定、可定制的性格。它内置了基于“大五人格模型”设计的引擎，允许用户精确调整AI的开放性、尽责性、外向性、亲和性和情绪稳定性等特质，从而让AI的交流风格不再是千篇一律的通用模板。

功能列表

• 一致的人格表现: 确保在所有兼容的AI工具中，AI展现出相同且统一的性格。
• 灵活的人格定制: 用户可以根据“大五”人格模型的五个维度（开放性、尽责性、外向性、亲和性、神经质或情绪稳定性）进行1到10级的精细调节。
• 预设人格模板: 内置8种优化好的人格预设（如专业、有创造力、有同理心等），方便用户在不同场景下快速选用。
• 本地化部署: 作为一个本地服务器运行，响应速度快。
• 兼容MCP生态: 可以与任何支持模型上下文协议（MCP）的客户端无缝集成，例如Claude Desktop、Cursor等。
• API密钥支持: 支持通过配置API密钥来保护服务安全。
• 提供多种工具接口: 开发者可以通过inject_personality（注入自定义人格）、inject_preset_personality（注入预设人格）等命令与服务交互。

使用帮助

ClueoMCP的定位是模型上下文协议（MCP）生态中的一个服务器，它通过为AI助手的响应注入“人格”，使得AI的输出更具一致性和特定风格。下面将详细介绍其安装和使用流程。

准备工作

在开始之前，你需要确保电脑中已经安装了以下软件：

1. Node.js: 需要 18 或以上版本。
2. 一个兼容MCP的客户端: 这是你用来与AI进行交互的应用，例如Claude Desktop、Cursor、Windsurf等。

安装流程

你可以选择两种方式来安装ClueoMCP服务器。

方式一：使用NPM进行全局安装（推荐）
这是最简单快捷的方式，适合大多数用户。

1. 打开你的终端（在Windows上是命令提示符或PowerShell，在macOS或Linux上是终端）。
2. 输入以下命令来全局安装clueo-mcp包：

   npm install -g clueo-mcp
   

3. 安装完成后，直接在终端输入以下命令即可启动服务器：

   clueo-mcp
   

   如果终端没有报错，并显示服务器正在运行，说明启动成功。

方式二：从源代码安装
这种方式适合希望进行二次开发或深入了解其工作原理的开发者。

1. 克隆代码库: 打开终端，使用git命令将项目代码从GitHub克隆到你的本地电脑。

   git clone https://github.com/ClueoFoundation/ClueoMCP.git
   

2. 进入项目目录:

   cd ClueoMCP
   

3. 安装依赖: 使用npm安装项目所需的所有依赖库。

   npm install
   

4. 配置环境变量:
   项目根目录下有一个名为env.example的文件，你需要复制它并重命名为.env。

   cp env.example .env
   

   然后，使用文本编辑器打开.env文件。这个文件用于配置服务器。其中CLUEO_API_KEY是可选的，如果你拥有Clueo的API密钥，可以填入以获取更高级的服务。对于基础使用，可以留空。

5. 编译和启动:
   首先，编译TypeScript代码为JavaScript。

   npm run build
   

   然后，启动服务器。

   npm start
   

连接到AI客户端（以Claude Desktop为例）

服务器启动后，你需要让你的AI客户端知道这个“人格层”的存在。

1. 找到Claude Desktop应用的配置文件，通常是一个名为claude_desktop_config.json的文件。
2. 打开这个JSON文件，在mcpServers字段中添加一个新的服务器配置，如下所示：

   {
   "mcpServers": {
   "clueo-personality": {
   "command": "node",
   "args": ["/path/to/clueomcp/dist/server.js"],
   "env": {
   "CLUEO_API_URL": "https://backend.clueoai.com"
   }
   }
   }
   }
   

   注意: 请将"/path/to/clueomcp/dist/server.js"替换为你电脑上server.js文件的实际绝对路径。如果你是使用源代码安装的，这个文件位于项目目录的dist文件夹下。

核心功能操作

ClueoMCP提供了几个核心的工具接口，你可以通过MCP客户端调用它们。

1. 注入自定义人格 (inject_personality)
   这个工具允许你根据“大五”人格模型的五个维度精确地塑造AI的性格。每个维度的值范围是1-10。
   • 使用示例:

     {
     "text": "你好，今天我能为你做些什么？",
     "personality": {
     "openness": 7,
     "conscientiousness": 8,
     "extraversion": 6,
     "agreeableness": 9,
     "neuroticism": 3
     }
     }
     

   • 参数说明:
     • openness (开放性): 控制创造力和好奇心。
     • conscientiousness (尽责性): 控制条理性和可靠性。
     • extraversion (外向性): 控制社交性和活力。
     • agreeableness (亲和性): 控制合作性和同理心。
     • neuroticism (情绪不稳定性): 控制焦虑和情绪波动。
2. 注入预设人格 (inject_preset_personality)
   如果你不想手动调整参数，可以直接使用内置的预设人格。
   • 使用示例:

     {
     "text": "你好，今天我能为你做些什么？",
     "presetId": "empathetic"
     }
     

   • 可用的presetId:
     • professional: 平衡、可靠，适合商务沟通。
     • creative: 富有想象力，适合头脑风暴。
     • empathetic: 温暖、有同理心，适合客户支持。
     • analytical: 逻辑严谨、注重细节，适合编写技术文档。
     • enthusiastic: 充满活力，适合团队领导。
     • casual-friend: 放松、对话式，适合非正式聊天。
     • luxury-brand: 精致、独特，适合高端品牌宣传。
     • startup-brand: 大胆、创新，适合科技创业公司。
3. 模拟带有人格的回应 (simulate_response)
   此工具可以直接让AI用特定的人格来生成对某个提示的回应。
   • 使用示例:

     {
     "prompt": "客户对我们的服务感到非常失望",
     "personality": {
     "openness": 6,
     "conscientiousness": 8,
     "extraversion": 5,
     "agreeableness": 9,
     "neuroticism": 2
     }
     }
     

应用场景

1. 客户支持
   在客户服务场景中，可以为AI客服注入empathetic（有同理心）的人格。这样，当AI回复用户的问题时，语言会更温暖、更能理解用户的情绪，而不是冷冰冰的机器式回答，从而提升用户体验。
2. 品牌声音一致性
   企业可以根据自己的品牌定位，定制一个专属的AI人格。例如，一个奢侈品牌可以设定一个luxury-brand（高端品牌）的人格，确保所有通过AI生成的内容，无论是营销文案还是产品介绍，都符合其精致、独特的品牌形象。
3. 内容创作
   内容创作者在进行头脑风暴或撰写初稿时，可以切换到creative（有创造力）的人格。这能让AI生成更具想象力、不拘一格的文本，为创作提供灵感。
4. 技术文档编写
   在编写需要高度精确性和逻辑性的技术文档时，可以将AI的人格切换为analytical（分析型）。这能让AI生成条理清晰、注重细节且准确的文字说明，例如解释一个API如何工作。

QA

1. 什么是模型上下文协议（MCP）？
   模型上下文协议（MCP）是一个开放标准，作用类似于AI领域的“USB-C”接口。 它旨在为大型语言模型（LLM）与各种外部工具（如数据库、API）和数据源提供一个标准化的连接方式，让开发者不必为每个AI模型和应用都单独开发一套集成方案。
2. 使用ClueoMCP是否必须要有Clueo API密钥？
   不是必须的。根据其GitHub页面的说明，CLUEO_API_KEY是可选配置。对于基础的、本地的人格注入功能，用户不需要API密钥也可以使用。API密钥可能是用于访问Clueo云端提供的更高级或付费的功能。
3. “大五”人格模型具体指什么？
   “大五”人格模型（The Big Five）是现代心理学中应用最广的人格理论之一，它将人的性格归纳为五个主要维度：开放性（Openness）、尽责性（Conscientiousness）、外向性（Extraversion）、亲和性（Agreeableness）和神经质（Neuroticism）。ClueoMCP正是利用这五个维度，通过1-10的数值来量化和定义AI的人格特质。
4. 这个工具支持哪些AI模型？
   ClueoMCP本身不直接限制AI模型，它的兼容性取决于AI客户端。只要你使用的AI应用或客户端支持模型上下文协议（MCP），理论上就可以通过这个客户端与ClueoMCP服务器连接，进而为客户端背后所使用的任何大型语言模型（如GPT系列、Claude系列等）添加人格层。