Integrations
Used for HTTP requests to communicate with the Onyx API
The runtime environment for the MCP server
The programming language used to build the MCP server
コンテキストバンクMCP
概要
Context Bank MCPは、Model Context Protocol(MCP)を用いて、API経由でAtherOSナレッジベースにクエリを実行するためのインターフェースを作成するプロジェクトです。このプロジェクトでは、Onyx APIと連携してチャットセッションを作成し、ナレッジベースにクエリを送信できるMCPサーバーを構築します。
特徴
- ナレッジベースを照会するための新しいチャットセッションを作成する
- チャットセッションにメッセージを送信して、ナレッジベースからの応答を受け取ります
- 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
This server cannot be installed
API を介して AtherOS ナレッジ ベースをクエリするためのインターフェイスを提供する MCP サーバー。これにより、ユーザーはチャット セッションを作成し、クエリを送信して情報を取得できます。