コンテキストバンク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

インストール

# Install dependencies
npm install

# Compile source code
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 Configuration
ONYX_API_KEY=your_api_key_here
ONYX_API_BASE=http://your_api_base_url:port

# Server Configuration
PORT=3000
NODE_ENV=development

# Optional: Logging Configuration
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 : 環境モード（開発、本番、テスト）

   • LOG_LEVEL : ログレベル（情報、デバッグ、エラー、警告）

使用法

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

# Direct usage
./build/index.js

# Or through npm
npm start

APIツール

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

1. チャットセッションを作成する

ナレッジ ベースを照会するための新しいチャット セッションを作成します。

パラメータ:

• persona_id (デフォルト: 0): ユーザーID

• description （デフォルト: ""）: チャットセッションの説明

2. query_atheros

AtherOS ナレッジベースを照会するためにチャット セッションにメッセージを送信します。

パラメータ:

• chat_session_id : チャットセッションID

• message : メッセージの内容

• parent_message_id : 親メッセージID（nullでも可）

応答フォーマット

ナレッジ ベース クエリからの応答には次のものが含まれます。

• メッセージID

• メッセージの内容

• 言い換えられたクエリ（利用可能な場合）

• 上位ソース ドキュメントに関する情報 (利用可能な場合):

  • 文書名

  • 関連性スコア

  • 文書へのリンク

建築

プロジェクトはシンプルな構造で構成されています。

• src/index.ts : アプリケーションのメインエントリポイント。MCPツールと接続ロジックを定義します。

• stdioプロトコルを使用してMCPサーバーと通信します

発達

# Compile and view changes
npm run build

# Run in development mode
npm run dev

ライセンス

ISC