Cline Personas MCP 服务器使用说明

项目简介

Cline Personas MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在帮助开发者管理和定制 LLM (大型语言模型) 的行为。它通过组件和角色模板的概念，使得用户可以灵活地定义和调整 LLM 的交互方式和上下文信息。

主要功能点

组件管理: 允许创建、读取、更新和删除可复用的文本组件。你可以将常用的文本片段或指令保存为组件，并在不同的角色模板中重复使用。
角色模板: 支持使用 Mustache 风格的变量占位符定义角色模板。角色模板可以引用已有的组件，从而组合成更复杂的 Prompt，用于引导 LLM 的行为。
依赖验证: 在创建或更新角色模板时，服务器会自动验证模板中引用的组件是否存在，避免配置错误。
角色激活: 通过简单的命令即可激活指定的角色，激活后，服务器会将该角色的模板写入 '.clinerules' 文件，从而影响使用该配置的 LLM 应用的行为。
版本跟踪: 组件和角色模板都支持版本管理，方便跟踪和回溯配置变更。
文件存储: 组件和角色模板以 JSON 文件的形式存储在本地文件系统中，易于管理和备份。

安装步骤

克隆仓库

git clone https://github.com/bradfair/mcp-cline-personas.git
cd mcp-cline-personas

安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置

为了让 MCP 客户端能够连接到 Cline Personas MCP 服务器，你需要提供以下配置信息。这些信息通常配置在 MCP 客户端的应用设置中。

{
  "serverName": "cline-persona-server",  // MCP 服务器名称，与服务器声明的名称一致
  "command": "npm",                   // 启动服务器的命令，这里使用 npm
  "args": ["start"]                    // 启动命令的参数，使用 "start" 运行 npm start 脚本
}

配置参数注释:

'serverName': 服务器的名称，客户端通过此名称识别服务器。
'command': 启动服务器进程的可执行命令。本例中使用 'npm'，假设你的环境中已安装 Node.js 和 npm。
'args': 传递给 'command' 的参数列表。'["start"]' 对应于运行仓库 'package.json' 中定义的 'start' 脚本，该脚本通常会启动服务器程序。

注意:

确保你的环境中已安装 Node.js 和 npm。
MCP 客户端需要能够执行 'npm start' 命令来启动服务器。这通常意味着客户端需要在可以访问到克隆仓库的上下文中运行。
上述配置假设你使用 'npm start' 命令启动服务器。如果你的启动命令不同（例如直接运行构建后的 JavaScript 文件），请相应地修改 'command' 和 'args'。

基本使用方法

启动服务器: 按照上述服务器配置，通过 MCP 客户端启动 Cline Personas MCP 服务器。
管理组件和角色: MCP 服务器提供了一系列工具 (Tools)，客户端可以通过调用这些工具来管理组件和角色。例如：
- 使用 'listComponents' 工具列出所有可用的组件。
- 使用 'createOrUpdateComponent' 工具创建或更新组件。
- 使用 'listPersonas' 工具列出所有可用的角色模板。
- 使用 'createOrUpdatePersona' 工具创建或更新角色模板。
- 使用 'activatePersona' 工具激活指定的角色模板。
- 使用 'getActivePersona' 工具获取当前激活的角色模板名称。
在 LLM 应用中使用: 当角色被激活后，'.clinerules' 文件会被更新为当前激活角色的模板内容。你的 LLM 应用可以读取 '.clinerules' 文件，并根据其中的模板内容来调整其行为。

提示: 请参考仓库中的 'test/server.test.ts' 文件，该文件包含了如何通过 MCP 客户端与服务器进行交互的示例代码，可以帮助你更好地理解如何使用服务器提供的工具。

关键词