Role Specific Context MCP Server

🚀 ロールベースのコンテキスト管理MCPサーバー

このMCPサーバーは、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モデルの選択

✨ 主な機能

ロール管理

• カスタムロールの作成、更新、および削除
• 特定の専門知識を持つ事前定義されたロール
• ロール専用のシステムプロンプトと命令
• カスタマイズ可能な語調設定

メモリ管理

• ロール専用のメモリストレージ
• 現在のクエリとの関連性に基づいてメモリを検索する
• メモリの有効期限（TTL）
• 各ロールのメモリ制限

MCP統合

• ロールをMCPリソースとして公開する
• ロール管理とクエリ処理のツールを提供する
• ロールベースのインタラクションに基づくプロンプトを提供する

📦 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）

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

console.log(response.data.response);

カスタムロールを作成する

// create-roleツールを使用する例
const result = await client.executeToolRequest({
  name: 'create-role',
  parameters: {
    id: 'tech-writer',