Context Bank

🚀 上下文銀行MCP

上下文銀行MCP基於模型上下文協議（MCP）構建，旨在打造一個查詢AtherOS知識庫的API接口。它搭建了MCP服務器，可與Onyx API交互，創建聊天會話並向知識庫發送查詢。

🚀 快速開始

上下文銀行MCP是一個強大的工具，能幫助你便捷地查詢AtherOS知識庫。按照以下步驟操作，即可快速開啟使用之旅。

✨ 主要特性

• 🔍 創建新的聊天會話以查詢知識庫。
• 💬 發送消息到聊天會話以接收來自知識庫的回答。
• 📄 格式化和顯示從Onyx API獲得的結果。

📦 安裝指南

安裝依賴

# 安裝依賴
npm install

# 編譯源代碼
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配置
ONYX_API_KEY=your_api_key_here
ONYX_API_BASE=http://your_api_base_url:port

# 服務器配置
PORT=3000
NODE_ENV=development

# 可選：日誌記錄配置
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：運行時環境模式（development, production, test）。
   • LOG_LEVEL：日誌級別（info, debug, error, warn）。

💻 使用示例

在編譯後，您可以使用命令行工具：

# 直接使用
./build/index.js

# 或通過npm
npm start

📚 詳細文檔

API工具

該項目提供了兩個主要的MCP工具：

1. create_chat_session

創建一個新的聊天會話以查詢知識庫。 參數：

• 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服務器通信。

開發命令

# 編譯並查看更改
npm run build

# 開發模式下運行
npm run dev

📄 許可證

本項目採用ISC許可證。