Role Specific Context

🚀 基於角色的上下文管理 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 模型選擇

✨ 主要特性

角色管理

• 創建、更新和刪除自定義角色
• 預定義角色及其特定領域 expertise
• 基於角色的系統提示和指令
• 可自定義的語氣配置文件

內存管理

• 角色專用內存存儲
• 根據當前查詢的相關性檢索記憶
• 記憶的有效期（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）

// 使用 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 策略'
});

創建自定義角色

// 使用 create-role 工具的示例
const result = await client.executeToolRequest({
  name: 'create-role',
  parameters: {
    roleId: 'creative-writer',
    instructions: '生成有創意的故事點子'
  }
});

📚 詳細文檔

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

📄 許可證

[此處插入許可證信息]

貢獻者

• [在此處列出貢獻者]

聯繫方式

• 項目主頁：[此處插入項目主頁鏈接]
• 問題反饋：[此處插入問題反饋郵箱]