コンテキストバンクMCP
概要
Context Bank MCPは、Model Context Protocol（MCP）を用いて、API経由でAtherOSナレッジベースにクエリを実行するためのインターフェースを作成するプロジェクトです。このプロジェクトでは、Onyx APIと連携してチャットセッションを作成し、ナレッジベースにクエリを送信できるMCPサーバーを構築します。
Related MCP server: Astro Docs MCP Server
特徴
ナレッジベースを照会するための新しいチャットセッションを作成する
チャットセッションにメッセージを送信して、ナレッジベースからの応答を受け取ります
Onyx API からの結果をフォーマットして表示する
使用される技術
タイプスクリプト
Node.js
モデルコンテキストプロトコル（MCP）SDK
データ検証のためのZod
HTTPリクエスト用のAxios
インストール
構成
このプロジェクトは、Onyx APIに接続するために環境変数を使用します。環境を設定するには、以下の手順に従ってください。
自動セットアップ（推奨）
セットアップ スクリプトを実行して、環境を対話的に構成します。
このスクリプトは次のことを行います。
.envファイルが存在しない場合は作成しますAtherOS APIキーの入力を求められます
APIベースURLをカスタマイズできます
その他の設定オプションのデフォルト値を設定する
手動設定
独自の環境ファイルを作成するには、サンプル環境ファイルをコピーします。
特定の構成で
.envファイルを編集します。
環境変数
必要な環境変数:
ONYX_API_KEY: AtherOS APIキーONYX_API_BASE: AtherOS APIのベースURL（例：「 http://172.30.22.52:3000 」）
オプションの環境変数:
PORT: サーバーのポート番号（デフォルト: 3000）NODE_ENV: 環境モード（開発、本番、テスト）LOG_LEVEL: ログレベル（情報、デバッグ、エラー、警告）
使用法
コンパイル後、コマンドライン ツールを使用できます。
APIツール
このプロジェクトでは、主に 2 つの MCP ツールが提供されます。
1. チャットセッションを作成する
ナレッジ ベースを照会するための新しいチャット セッションを作成します。
パラメータ:
persona_id(デフォルト: 0): ユーザーIDdescription（デフォルト: ""）: チャットセッションの説明
2. query_atheros
AtherOS ナレッジベースを照会するためにチャット セッションにメッセージを送信します。
パラメータ:
chat_session_id: チャットセッションIDmessage: メッセージの内容parent_message_id: 親メッセージID（nullでも可）
応答フォーマット
ナレッジ ベース クエリからの応答には次のものが含まれます。
メッセージID
メッセージの内容
言い換えられたクエリ（利用可能な場合）
上位ソース ドキュメントに関する情報 (利用可能な場合):
文書名
関連性スコア
文書へのリンク
建築
プロジェクトはシンプルな構造で構成されています。
src/index.ts: アプリケーションのメインエントリポイント。MCPツールと接続ロジックを定義します。stdioプロトコルを使用してMCPサーバーと通信します
発達
ライセンス
ISC