Role Specific Context MCP Server

🚀 基于角色的上下文管理MCP服务器

本MCP服务器为AI代理实现了基于角色的上下文管理，能为不同AI代理设定明确指示、目标与领域知识，对角色记忆分区管理，还可动态调整语气风格，有效提升AI交互的专业性与针对性。

🚀 快速开始

先决条件

• Node.js 18+版本
• OpenAI API密钥

安装

# 克隆仓库
git clone https://github.com/yourusername/role-context-mcp.git
cd role-context-mcp

# 安装依赖项
npm install

# 设置环境变量
echo "OPENAI_API_KEY=your_api_key_here" > .env

# 构建项目
npm run build

运行服务器

# 运行MCP服务器
npm start

# 运行HTTP服务器进行测试
npm run start:http

配置

通过修改src/config.ts可以配置服务器。关键配置选项包括：

• 默认角色及其属性
• 可用的语气配置
• 内存管理设置
• OpenAI模型选择

✨ 主要特性

角色管理

• 创建、更新和删除自定义角色
• 带有特定专业知识的预定义角色
• 角色专用的系统提示和指令
• 可定制的语气配置

内存管理

• 角色专用的记忆存储
• 根据当前查询的相关性检索记忆
• 记忆的有效期（TTL）
• 每个角色的记忆限制

MCP集成

• 将角色暴露为MCP资源
• 提供角色管理和查询处理的工具
• 提供基于角色交互的提示

📦 安装指南

安装步骤

# 克隆仓库
git clone https://github.com/yourusername/role-context-mcp.git
cd role-context-mcp

# 安装依赖项
npm install

# 设置环境变量
echo "OPENAI_API_KEY=your_api_key_here" > .env

# 构建项目
npm run build

💻 使用示例

基础用法

使用角色处理查询（MCP）

// 使用process-with-role工具的示例
const result = await client.executeToolRequest({
  name: 'process-with-role',
  parameters: {
    roleId: 'marketing-expert',
    query: '如何提高我的社交媒体参与度？',
    customInstructions: '专注于B2B策略'
  }
});

使用HTTP API处理查询

// 使用HTTP API的示例
const response = await axios.post('http://localhost:3000/process', {
  roleId: 'marketing-expert',
  query: '如何提高我的社交媒体参与度？',
  customInstructions: '专注于B2B策略'
});

console.log(response.data.response);

创建自定义角色

// 使用create-role工具的示例
const result = await client.executeToolRequest({
  name: 'create-role',
  parameters: {
    id: 'tech-writer',

📚 详细文档

MCP集成

资源

服务器公开以下资源：

• role://{roleId} - 特定角色的信息
• role://tones - 可用的语气配置

工具

服务器提供的工具包括：

• process-with-role - 使用特定角色处理查询
• create-role - 创建新角色
• update-role - 更新现有角色
• delete-role - 删除自定义角色
• change-role-tone - 更改角色的语气
• store-memory - 为特定角色存储记忆
• clear-role-memories - 清除某个角色的所有记忆

提示

服务器提供的提示包括：

• role-{roleId} - 使用特定角色处理请求
• create-custom-role - 创建新自定义角色