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 - 創建新自定義角色