Role-Specific Context MCP Server

特定角色上下文 MCP 服务

一个 Model Context Protocol（MCP）服务，用于根据系统中的 Agent 角色定义和管理上下文边界。

概述

此 MCP 服务支持 AI Agent 的基于角色的上下文管理，让你可以：

• 为每个 AI Agent（营销专家、歌曲创作者、行政助理等）设定明确的指令、目标和领域知识
• 将与角色相关的记忆分区并限定范围，避免不同 Agent 角色之间相互干扰
• 根据角色动态调整语气和风格（严肃、风趣、讽刺），并将语气配置预置到提示词中

功能

角色管理

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

记忆管理

• 存储角色专属记忆
• 根据与当前查询的相关性检索记忆
• 为记忆设置生存时间（TTL）
• 设置每个角色的记忆数量限制

MCP 集成

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

入门

前置条件

• Node.js 18+
• OpenAI API 密钥

安装

# Clone the repository
git clone https://github.com/yourusername/role-context-mcp.git
cd role-context-mcp

# Install dependencies
npm install

# Set up environment variables
echo "OPENAI_API_KEY=your_api_key_here" > .env

# Build the project
npm run build

运行服务

# Run the MCP server
npm start

# Run the HTTP server for testing
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）

// Example of using the process-with-role tool
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）

// Example of using the 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);

创建自定义角色

// Example of using the create-role tool
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