ClueoMCP: uma ferramenta para adicionar traços de personalidade a modelos de linguagem em grande escala (LLMs)

O ClueoMCP é uma ferramenta de código aberto cuja função principal é injetar traços de personalidade predefinidos em modelos de linguagem grandes (LLMs). A ferramenta é executada como um servidor e segue o Protocolo de Contexto de Modelo (MCP), um protocolo projetado para padronizar a maneira como os aplicativos de IA se conectam a ferramentas e dados externos. Em termos simples, o ClueoMCP atua como uma "camada de personalidade" entre o aplicativo de IA e o modelo de IA. Quando um usuário interage com um assistente de IA compatível com MCP (por exemplo, alguns aplicativos de IA para desktop), o ClueoMCP intercepta e ajusta os comandos para que cada resposta da IA tenha uma personalidade estável e personalizável. Ele tem um mecanismo incorporado baseado no modelo de personalidade Big Five, que permite ao usuário ajustar com precisão os traços de abertura, obediência, extroversão, afabilidade e estabilidade emocional da IA, de modo que o estilo de comunicação da IA não seja mais um modelo genérico que possa ser usado de forma única.

Lista de funções

• Desempenho consistente da personalidadeIA: garantir que a IA apresente o mesmo caráter uniforme em todas as ferramentas de IA compatíveis.
• Personalização flexível da personalidade: os usuários podem fazer ajustes finos em uma escala de 1 a 10 com base nas cinco dimensões do modelo de personalidade Big Five (abertura, consciência, extroversão, afinidade, neuroticismo ou estabilidade emocional).
• Modelos de personalidade predefinidos8 predefinições de personalidade otimizadas (por exemplo, profissional, criativa, empática etc.) são incorporadas para seleção rápida em diferentes cenários.
• Implementação localizadaServidor local: é executado como um servidor local e é responsivo.
• Compatível com o ecossistema MCPIntegração perfeita com qualquer cliente que ofereça suporte ao protocolo de contexto de modelo (MCP), como Claude Desktop, Cursor, etc.
• Suporte a chaves de APISuporte para proteção de serviços por meio da configuração de chaves de API.
• Fornecer várias interfaces de ferramentasO desenvolvedor pode usar oinject_personality(Injetando personalidades personalizadas),inject_preset_personality（Comandos como (injetar personalidade predefinida) interagem com o serviço.

Usando a Ajuda

O ClueoMCP está posicionado como um servidor no ecossistema do Protocolo de Contexto de Modelo (MCP), que injeta "personalidade" nas respostas dos assistentes de IA para tornar a saída da IA mais consistente e específica ao estilo. O processo de instalação e uso é descrito em detalhes a seguir.

preliminar

Antes de começar, você precisa se certificar de que o software a seguir esteja instalado no computador:

1. Node.js:: Obrigatório 18 ou superior.
2. Um cliente compatível com MCPAplicativo: Este é o aplicativo que você usa para interagir com a IA, por exemploClaude DesktopeCursoreWindsurfetc.

Processo de instalação

Você pode escolher entre duas maneiras de instalar o servidor ClueoMCP.

Caminho 1: instalação global usando o NPM (recomendado)
Essa é a maneira mais fácil e rápida para a maioria dos usuários.

1. Abra seu terminal (Prompt de Comando ou PowerShell no Windows, Terminal no macOS ou Linux).
2. Digite o seguinte comando para instalar globalmenteclueo-mcpPacote:

   npm install -g clueo-mcp
   

3. Após a conclusão da instalação, inicie o servidor digitando o seguinte comando diretamente no terminal:

   clueo-mcp
   

   Se o terminal não relatar erros e mostrar que o servidor está em execução, a inicialização foi bem-sucedida.

Maneira 2: Instalar a partir do código-fonte
Essa abordagem é adequada para desenvolvedores que desejam fazer um desenvolvimento secundário ou obter uma compreensão mais profunda de como ele funciona.

1. Clonagem da base de códigoAbra um terminal e usegitpara clonar o código do projeto do GitHub em seu computador local.

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

2. Vá para o diretório do projeto:

   cd ClueoMCP
   

3. Instalação de dependências: UsonpmInstale todas as bibliotecas dependentes exigidas pelo projeto.

   npm install
   

4. Configuração de variáveis de ambiente:
   O diretório raiz do projeto tem um arquivo chamadoenv.examplevocê precisa copiá-lo e renomeá-lo para.env.

   cp env.example .env
   

   Em seguida, use um editor de texto para abrir o arquivo.envfile. Esse arquivo é usado para configurar o servidor. Um dos arquivosCLUEO_API_KEYé opcional e pode ser preenchido para serviços mais avançados se você tiver uma chave de API para o Clueo. Para uso básico, você pode deixá-la em branco.

5. Compilar e iniciar:
   Primeiro, compile o código TypeScript para JavaScript.

   npm run build
   

   Em seguida, inicie o servidor.

   npm start
   

Conectando-se a um cliente de IA (Claude Desktop como exemplo)

Depois que o servidor for iniciado, você precisará informar aos seus clientes de IA que essa "camada de personalidade" existe.

1. localizarClaude DesktopO arquivo de configuração do aplicativo, geralmente um arquivo chamadoclaude_desktop_config.jsondo documento.
2. Abra esse arquivo JSON nomcpServerspara adicionar uma nova configuração de servidor, conforme mostrado abaixo:

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

   tomar nota de:: Favor enviar"/path/to/clueomcp/dist/server.js"Substitua-o pelo que está em seu computadorserver.jsO caminho absoluto real para o arquivo. Se você estiver instalando com o código-fonte, esse arquivo estará localizado no diretório do projeto do arquivodistpasta.

Operação da função principal

O ClueoMCP fornece várias interfaces de ferramentas principais que você pode chamar por meio do cliente MCP.

1. Injete uma personalidade personalizada (inject_personality)
   Essa ferramenta permite moldar com precisão a personalidade de sua IA de acordo com as cinco dimensões do modelo de personalidade Big Five. Cada dimensão tem um intervalo de valores de 1 a 10.
   • exemplo de uso:

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

   • Descrição do parâmetro:
     • openness (Abertura): Controle da criatividade e da curiosidade.
     • conscientiousness (Due diligence): organização e confiabilidade do controle.
     • extraversion (Extroversão)/Controle da socialidade e da energia.
     • agreeableness (Afinidade)/Controle, cooperação e empatia.
     • neuroticism (Instabilidade de humor): Controle da ansiedade e das mudanças de humor.
2. Injetar uma personalidade predefinida (inject_preset_personality)
   Se você não quiser ajustar os parâmetros manualmente, basta usar as personalidades predefinidas incorporadas.
   • exemplo de uso:

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

   • utilizávelpresetId:
     • professionalEquilibrado e confiável para comunicação comercial.
     • creativeImaginação: Imaginativo e bom para brainstorming.
     • empatheticAtendimento ao cliente: caloroso e empático.
     • analyticalConhecimento de informática: lógico e detalhista, adequado para documentação técnica.
     • enthusiasticEnergia: Energético e adequado para liderar equipes.
     • casual-friendDescrição: Descontraído, coloquial, adequado para bate-papos informais.
     • luxury-brandCaracterísticas: Requintado e exclusivo, adequado para a promoção de marcas de alta qualidade.
     • startup-brand: Ousado e inovador para startups de tecnologia.
3. Modelagem de respostas com personalidade (simulate_response)
   Essa ferramenta permite que a IA gere diretamente uma resposta a um prompt usando uma personalidade específica.
   • exemplo de uso:

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

cenário do aplicativo

1. Suporte ao cliente
   Em cenários de atendimento ao cliente, o atendimento ao cliente com IA pode ser infundido comempatheticpersonalidades (com empatia). Dessa forma, quando a IA responder à pergunta de um usuário, a linguagem será mais calorosa e compreenderá melhor as emoções do usuário, em vez de uma resposta fria e mecânica, melhorando assim a experiência do usuário.
2. Consistência da voz da marca
   As empresas podem personalizar uma personalidade de IA exclusiva com base no posicionamento de sua marca. Por exemplo, uma marca de luxo poderia definir umaluxury-brand(uma marca premium), garantindo que todo o conteúdo gerado por meio de IA, seja uma cópia de marketing ou apresentações de produtos, esteja alinhado com a imagem sofisticada e exclusiva da marca.
3. criação de conteúdo
   Quando os criadores de conteúdo estão fazendo um brainstorming ou escrevendo um primeiro rascunho, eles podem alternar para ocreativepersonalidade (criativa). Isso permite que a IA gere textos mais imaginativos e ecléticos, que fornecem inspiração para a escrita criativa.
4. Documentação técnica
   Ao escrever uma documentação técnica que exija um alto grau de precisão e lógica, você pode mudar a personalidade da IA paraanalytical(Analítico). Isso permite que a IA gere descrições textuais bem organizadas, orientadas a detalhes e precisas, por exemplo, explicando como uma API funciona.

QA

1. O que é o protocolo de contexto de modelo (MCP)?
   O protocolo de contexto de modelo (MCP) é um padrão aberto que funciona como uma interface "USB-C" no domínio da IA. Seu objetivo é fornecer uma maneira padronizada de conectar modelos de linguagem grandes (LLMs) a várias ferramentas externas (por exemplo, bancos de dados, APIs) e fontes de dados, para que os desenvolvedores não precisem desenvolver uma solução de integração separada para cada modelo e aplicativo de IA.
2. É necessário ter uma chave de API do Clueo para usar o ClueoMCP?
   Não é necessário. De acordo com as instruções em sua página do GitHub, oCLUEO_API_KEYé uma configuração opcional. Para a funcionalidade básica de injeção de personalidade local, os usuários podem usá-la sem uma chave de API. A chave de API pode ser usada para acessar funcionalidades mais avançadas ou pagas fornecidas pelo Clueo Cloud.
3. "O que significa exatamente o modelo de personalidade Big Five?
   "O Big Five é uma das teorias de personalidade mais amplamente utilizadas na psicologia moderna e resume a personalidade humana em cinco dimensões principais: Abertura, Conscienciosidade, Extroversão, Amabilidade e Neuroticismo. O ClueoMCP usa essas cinco dimensões para quantificar e definir os traços de personalidade de uma IA em uma escala de 1 a 10.
4. Quais modelos de IA são compatíveis com essa ferramenta?
   O ClueoMCP em si não restringe diretamente os modelos de IA; sua compatibilidade depende do cliente de IA. Desde que o aplicativo ou cliente de IA que você está usando seja compatível com o protocolo de contexto de modelo (MCP), é teoricamente possível conectar-se ao servidor ClueoMCP por meio desse cliente, o que, por sua vez, adiciona uma camada de personalidade a qualquer modelo de linguagem grande (por exemplo, a família GPT, a família Claude etc.) usado por trás do cliente.