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

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

.envファイルが存在しない場合は作成します
AtherOS APIキーの入力を求められます
APIベースURLをカスタマイズできます
その他の設定オプションのデフォルト値を設定する

手動設定

独自の環境ファイルを作成するには、サンプル環境ファイルをコピーします。

cp .env.example .env

特定の構成で.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

環境変数

必要な環境変数:
- ONYX_API_KEY : AtherOS APIキー
- ONYX_API_BASE : AtherOS APIのベースURL（例：「 http://172.30.22.52:3000 」）
オプションの環境変数:
- 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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related MCP Servers

MCP-Communicator-Telegram
qpd-v
-
security
F
license
-
quality
An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.
Last updated -
1
16
JavaScript
ClaudeKeep
sdairs
A
security
A
license
A
quality
An MCP server that enables saving and sharing Claude Desktop conversations, allowing users to store chats privately or make them public through a web interface.
Last updated -
2
6
TypeScript
MIT License
MCP Server Discord Webhook
genm
A
security
A
license
A
quality
An MCP server that enables posting messages to Discord webhooks, allowing customization of content, username, and avatar URL.
Last updated -
1
0
JavaScript
MIT License
Unstructured API MCP Serverofficial
Unstructured-IO
A
security
F
license
A
quality
An MCP server implementation that enables interaction with the Unstructured API, providing tools to list, create, update, and manage sources, destinations, and workflows.
Last updated -
39
28

View all related MCP servers

Context Bank MCP