Role Specific Context

🚀 Role-Based Context Management MCP Server

This MCP server provides role-based context management for AI agents, enabling you to establish 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 18+
• 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

Run the Server

# Start the MCP server
npm start

# Start 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 profiles
• Memory management settings
• OpenAI model selection

✨ Features

Role Management

• Create, update, and delete custom roles
• Pre-defined roles and their specific domain expertise
• Role-based system prompts and instructions
• Customizable tone profiles

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 role management and query processing tools
• Offer role-based interaction prompts

📦 MCP Integration

Resources

The server exposes the following resources:

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

Tools

The server provides the following tools:

• 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 server provides the following prompts:

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

💻 Usage Examples

Process Queries with a 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 increase my social media engagement?',
    customInstructions: 'Focus on B2B strategies'
  }
});

Process Queries with a Role (HTTP API)

// Example of using the HTTP API
const response = await axios.post('http://localhost:3000/process', {
  roleId: 'marketing-expert',
  query: 'How can I increase my social media engagement?',
  customInstructions: 'Focus on B2B strategies'
});

Create a Custom Role

// Example of using the create-role tool
const result = await client.executeToolRequest({
  name: 'create-role',
  parameters: {
    roleId: 'creative-writer',
    instructions: 'Generate creative story ideas'
  }
});

📄 License

[Insert license information here]

👥 Contributors

• [List contributors here]

📞 Contact

• Project Homepage: [Insert project homepage link here]
• Issue Reporting: [Insert issue reporting email here]