Context Bank MCP

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

インストール

# 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
  1. 特定の構成で.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. 必要な環境変数:
  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

-
security - not tested
A
license - permissive license
-
quality - not tested

API を介して AtherOS ナレッジ ベースをクエリするためのインターフェイスを提供する MCP サーバー。これにより、ユーザーはチャット セッションを作成し、クエリを送信して情報を取得できます。

  1. Overview
    1. Features
      1. Technologies Used
        1. Installation
          1. Configuration
            1. Automatic Setup (Recommended)
            2. Manual Setup
            3. Environment Variables
          2. Usage
            1. API Tools
              1. 1. create_chat_session
              2. 2. query_atheros
            2. Response Format
              1. Architecture
                1. Development
                  1. License
                    ID: 6cf9jhd48u