角色特定上下文 MCP 服务器

一个模型上下文协议 (MCP) 服务器，它基于系统中代理的角色定义和管理上下文边界。

概述

此 MCP 服务器为 AI 代理启用基于角色的上下文管理，使您能够：

• 为每个 AI 代理（营销专家、歌曲作者、行政助理等）建立明确的指令、目标和领域知识
• 保持角色相关的记忆被分区和限定范围，防止不同代理角色之间的交叉污染
• 根据角色动态调整语气和风格（严肃、诙谐、讽刺），并将语气配置文件嵌入到提示中

特性

角色管理

• 创建、更新和删除自定义角色
• 具有特定专业领域的预定义角色
• 角色特定的系统提示和指令
• 可定制的语气配置文件

内存管理

• 角色特定的内存存储
• 基于与当前查询的相关性检索内存
• 内存的生存时间 (TTL)
• 每个角色的内存限制

MCP 集成

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

入门

前提条件

• 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 模型选择

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 - 创建新的自定义角色

使用示例

使用角色处理查询 (MCP)

// 使用 process-with-role 工具的示例
const result = await client.executeToolRequest({
  name: 'process-with-role',
  parameters: {
    roleId: 'marketing-expert',
    query: 'How can I improve my social media engagement?',
    customInstructions: 'Focus on B2B strategies'
  }
});

使用角色处理查询 (HTTP API)

// 使用 HTTP API 的示例
const response = await axios.post('http://localhost:3000/process', {
  roleId: 'marketing-expert',
  query: 'How can I improve my social media engagement?',
  customInstructions: 'Focus on B2B strategies'
});

console.log(response.data.response);

创建自定义角色

// 使用 create-role 工具的示例
const result = await client.executeToolRequest({
  name: 'create-role',
  parameters: {
    id: 'tech-writer',
    name: 'Technical Writer',
    description: 'Specializes in clear, concise technical documentation',
    instructions: 'Create documentation that is accessible to both technical and non-technical audiences',
    domains: ['technical-writing', 'documentation', 'tutorials'],
    tone: 'technical',
    systemPrompt: 'You are an experienced technical writer with expertise in creating clear, concise documentation for complex systems.'
  }
});

许可证

MIT