Role-Specific Context MCP Server

役割別コンテキスト MCP サーバー

システム内のエージェントの役割に基づいて、コンテキストの境界を定義し、管理する Model Context Protocol（MCP）サーバーです。

概要

この MCP サーバーは、AI エージェント向けの役割ベースのコンテキスト管理を可能にし、次のことができます。

• 各 AI エージェント（マーケティングの専門家、ソングライター、エグゼクティブアシスタントなど）に、明確な指示、目標、専門分野の知識を設定する
• 役割に関連するメモリを分離して範囲を限定し、異なるエージェントの役割間での混同を防ぐ
• プロンプトに組み込まれたトーンプロファイルを使い、役割ごとにトーンやスタイル（真面目、機知に富んだ表現、皮肉など）を動的に調整する

機能

役割管理

• カスタム役割の作成、更新、削除
• 特定の専門分野を持つ事前定義済みの役割
• 役割ごとのシステムプロンプトと指示
• カスタマイズ可能なトーンプロファイル

メモリ管理

• 役割ごとのメモリ保存
• 現在のクエリとの関連性に基づくメモリの取得
• メモリの有効期限（TTL）
• 役割ごとのメモリ上限

MCP 統合

• 役割を MCP リソースとして公開
• 役割の管理とクエリ処理のツールを提供
• 役割ベースのやり取りに使うプロンプトを提供

はじめに

前提条件

• Node.js 18+
• OpenAI API キー

インストール

# 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

サーバーの実行

# Run the MCP server
npm start

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

設定

src/config.ts を編集してサーバーを設定できます。主な設定項目は次のとおりです。

• デフォルトの役割とそのプロパティ
• 使用可能なトーンプロファイル
• メモリ管理の設定
• OpenAI モデルの選択

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 - 新しいカスタム役割を作成する

使用例

役割を使ったクエリの処理（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'
  }
});

役割を使ったクエリの処理（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);

カスタム役割の作成

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

ライセンス

MIT