Context Bank

🚀 コンテキストバンクMCP

コンテキストバンクMCPは、モデルコンテキストプロトコル（MCP）に基づいて構築されたプロジェクトです。このプロジェクトの目的は、AtherOS知識ベースをクエリするAPIインターフェースを作成することです。MCPサーバーを構築し、Onyx APIとやり取りしてチャットセッションを作成し、知識ベースにクエリを送信することができます。

🚀 クイックスタート

コンテキストバンクMCPを使用することで、AtherOS知識ベースに簡単にクエリを送信し、必要な情報を取得することができます。以下の手順に従って、セットアップと使用を行ってください。

✨ 主な機能

• 知識ベースをクエリするための新しいチャットセッションを作成します。
• チャットセッションにメッセージを送信し、知識ベースからの回答を受け取ります。
• Onyx APIから取得した結果を整形して表示します。

🔧 技術詳細

このプロジェクトでは、以下の技術が使用されています。

• TypeScript
• Node.js
• モデルコンテキストプロトコル（MCP）SDK
• データ検証にZodを使用
• HTTPリクエストにAxiosを使用

📦 インストール

以下のコマンドを使用して、依存関係をインストールし、ソースコードをコンパイルします。

# 依存関係のインストール
npm install

# ソースコードのコンパイル
npm run build

🛠️ 設定

このプロジェクトは、環境変数を使用してOnyx APIに接続します。以下の手順に従って設定を行ってください。

自動設定（推奨）

設定スクリプトを実行して、環境を対話的に設定します。

npm run setup

このスクリプトは以下のことを行います。

1. .envファイルが存在しない場合は作成します。
2. AtherOS APIキーの入力を求めます。
3. APIベースURLのカスタマイズを許可します。
4. 他の設定オプションのデフォルト値を設定します。

手動設定

1. サンプル環境ファイルをコピーして、独自の設定を作成します。

cp .env.example .env

2. .envファイルを具体的な設定で編集します。

# AtherOS API設定
ONYX_API_KEY=your_api_key_here
ONYX_API_BASE=http://your_api_base_url:port

# サーバー設定
PORT=3000
NODE_ENV=development

# オプション：ログ記録設定
LOG_LEVEL=info

環境変数

1. 必須の環境変数：

   • ONYX_API_KEY：あなたのAtherOS APIキー
   • ONYX_API_BASE：AtherOS APIのベースURL（例：“http://172.30.22.52:3000”）

2. オプションの環境変数：

   • PORT：サーバーのポート番号（デフォルト：3000）
   • NODE_ENV：実行時の環境モード（development, production, test）
   • LOG_LEVEL：ログレベル（info, debug, error, warn）

💻 使用例

基本的な使用法

コンパイル後、コマンドラインツールを使用できます。

# 直接使用
./build/index.js

# またはnpmを通じて
npm start

高度な使用法

このプロジェクトでは、2つの主要なMCPツールが提供されています。

create_chat_session

知識ベースをクエリするための新しいチャットセッションを作成します。

パラメータ：

• persona_id（デフォルト：0）：ユーザーID
• description（デフォルト：“”）：チャットセッションの説明

query_atheros

チャットセッションにメッセージを送信して、AtherOS知識ベースをクエリします。

パラメータ：

• chat_session_id：チャットセッションID
• message：メッセージ内容
• parent_message_id：親メッセージID（null可）

📋 応答形式

知識ベースクエリの回答には以下が含まれます。

• メッセージID
• メッセージ内容
• 再述されたクエリ（利用可能な場合）
• トップソースドキュメントに関する情報（利用可能な場合）：
  • ドキュメント名
  • 関連性スコア
  • ドキュメントリンク

🛠️ 開発

開発中は、以下のコマンドを使用してコンパイルと実行を行います。

# コンパイルして変更を確認
npm run build

# 開発モードで実行
npm run dev

📄 ライセンス

このプロジェクトはISCライセンスの下で公開されています。