Role Specific Context MCP Server

🚀 Role-Based Context Management MCP Server

This MCP server implements role-based context management for AI agents, enabling you to set clear instructions, goals, and domain knowledge for each agent, partition and scope role-related memories, and dynamically adjust tone and style.

🚀 Quick Start

Prerequisites

• Node.js version 18 or higher
• OpenAI API key

Installation

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

# Install dependencies
npm install

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

# Build the project
npm run build

Running the Server

# Run the MCP server
npm start

# Run the HTTP server for testing
npm run start:http

Configuration

You can configure the server by modifying src/config.ts. Key configuration options include:

• Default roles and their attributes
• Available tone configurations
• Memory management settings
• OpenAI model selection

✨ Features

Role Management

• Create, update, and delete custom roles
• Pre-defined roles with specific expertise
• Role-specific system prompts and instructions
• Customizable tone configurations

Memory Management

• Role-specific memory storage
• Retrieve memories based on the relevance of the current query
• Memory time-to-live (TTL)
• Memory limits for each role

MCP Integration

• Expose roles as MCP resources
• Provide tools for role management and query processing
• Provide role-based interaction prompts

📦 MCP Integration

Resources

The server exposes the following resources:

• role://{roleId} - Information about a specific role
• role://tones - Available tone configurations

Tools

The tools provided by the server include:

• process-with-role - Process queries using a specific role
• create-role - Create a new role
• update-role - Update an existing role
• delete-role - Delete a custom role
• change-role-tone - Change the tone of a role
• store-memory - Store memories for a specific role
• clear-role-memories - Clear all memories of a role

Prompts

The prompts provided by the server include:

• role-{roleId} - Process requests using a specific role
• create-custom-role - Create a new custom role

💻 Usage Examples

Basic Usage

Using a Role to Process Queries (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'
  }
});

Using the HTTP API to Process Queries

// 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);

Advanced Usage

Creating a Custom Role

// Example of using the create-role tool
const result = await client.executeToolRequest({
  name: 'create-role',
  parameters: {
    id: 'tech-writer',