Role-Specific Context MCP Server

by Chris-June
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Manages environment variables for the MCP server, primarily for storing API keys like the OpenAI API key.

  • Used for making HTTP requests to the server's API, allowing clients to process queries with specific roles and interact with the role-based context management system.

  • Used for version control and initial project setup through cloning the repository.

Role-Specific Context MCP Server

A Model Context Protocol (MCP) server that defines and governs contextual boundaries based on agent roles in your system.

Overview

This MCP server enables role-based context management for AI agents, allowing you to:

  • Establish clear instructions, objectives, and domain knowledge for each AI agent (Marketing Expert, Songwriter, Executive Assistant, etc.)
  • Keep role-relevant memory partitioned and scoped, preventing cross-contamination between different agent roles
  • Adapt tone and style dynamically (serious, witty, sarcastic) per role, with tone profiles baked into the prompt

Features

Role Management

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

Memory Management

  • Role-specific memory storage
  • Memory retrieval based on relevance to current query
  • Time-to-live (TTL) for memories
  • Memory limits per role

MCP Integration

  • Exposes roles as MCP resources
  • Provides tools for role management and query processing
  • Offers prompts for role-based interactions

Getting Started

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 up 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

The server can be configured by modifying src/config.ts. Key configuration options include:

  • Default roles and their properties
  • Available tone profiles
  • Memory management settings
  • OpenAI model selection

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 a query 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 a memory for a specific role
  • clear-role-memories - Clear all memories for a role

Prompts

The server provides the following prompts:

  • role-{roleId} - Use a specific role to process a request
  • create-custom-role - Create a new custom role

Example Usage

Processing a Query 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 improve my social media engagement?', customInstructions: 'Focus on B2B strategies' } });

Processing a Query 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 improve my social media engagement?', customInstructions: 'Focus on B2B strategies' }); console.log(response.data.response);

Creating a Custom Role

// 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.' } });

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

A Model Context Protocol server that enables role-based context management for AI agents, allowing users to establish specific instructions, maintain partitioned memory, and adapt tone for different agent roles in their system.

  1. Overview
    1. Features
      1. Role Management
      2. Memory Management
      3. MCP Integration
    2. Getting Started
      1. Prerequisites
      2. Installation
      3. Running the Server
      4. Configuration
    3. MCP Integration
      1. Resources
      2. Tools
      3. Prompts
    4. Example Usage
      1. Processing a Query with a Role (MCP)
      2. Processing a Query with a Role (HTTP API)
      3. Creating a Custom Role
    5. License